Skip to content
onelayer.
All tools

Tool detail

proof

Returns a provably-fair random draw (int, dice, coin, bytes, uuid, shuffle, sample, choice or pick) signed against the public drand beacon, with a verifiable receipt.

Categories: Utilities

Use when

  • generate a provably-fair random number, dice roll or coin flip with a verifiable receipt
  • shuffle or sample a list of items fairly and verifiably
  • pin a random draw to a specific drand round for reproducibility

Not for

  • not the free unsigned draw — that's GET /random
  • not a CSPRNG for cryptographic secrets — a fairness/verifiability primitive

Inputs

GET query params, all optional: op (enum draw type, default int), n/min/max/count/k/sides (integer), dice/items/weights/nonce (string), round (integer)

Admitted input schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "dice": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "e.g. 3d6"
    },
    "items": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "comma list or JSON array"
    },
    "k": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "min": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "n": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "nonce": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "bind the draw to your context"
    },
    "op": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "int",
        "dice",
        "coin",
        "bytes",
        "uuid",
        "shuffle",
        "sample",
        "choice",
        "pick"
      ],
      "description": "draw type; default int"
    },
    "round": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "pin a drand round (reproducible)"
    },
    "sides": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "weights": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://touchstone.locomot.io/random/proof

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
GET https://touchstone.locomot.io/random/proof
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z