Skip to content
onelayer.
All tools

Tool detail

Roll

Generates one or more cryptographically random integers in a given range, signed by the service's treasury key as verifiable RNG.

Categories: Utilities

Use when

  • get a verifiable random integer or dice roll
  • draw a signed random number for a game outcome

Not for

  • not a source of cryptographic keys or wallet randomness

Inputs

POST JSON body: low, high (integers, required); count (1-100, default 1), commitment, label (optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "commitment": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional 32-byte hex pre-commitment from the caller."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many integers to sample. 1-100.",
      "default": 1
    },
    "high": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Inclusive high bound. Must be >= low."
    },
    "label": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200,
      "description": "Optional caller tag, included in the signed payload."
    },
    "low": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Inclusive low bound of the integer range."
    }
  },
  "required": [
    "low",
    "high"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://api.anchor-x402.com/v1/roll

Payment

Protocol
x402
Listed price
0.001 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://api.anchor-x402.com/v1/roll
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z