{"slug":"verifiable-random-use-x402atlas-com-shuffle-22f757","title":"Verifiable Random shuffle — a uniform Fisher-Yates permutation bound to a future","host":"verifiable-random.use.x402atlas.com","method":"POST","resource":"https://verifiable-random.use.x402atlas.com/shuffle","category":"other","description":"Verifiable Random shuffle — a uniform Fisher-Yates permutation bound to a future drand round the server waits for (typically 3-6s) and verifies locally, with original indices and a reproducible proof transcript.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":599,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:137","eip155:42161","eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"algorithm_version":"drand-hkdf-sha256-v1","client_seed":"meeting-2026-07-30","items":["alice","bob","carol"],"target_round":0},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"description":"String-list shuffle bound to a future drand round.","properties":{"algorithm_version":{"default":"drand-hkdf-sha256-v1","description":"Optional version guard; when supplied it must match the server's pinned derivation algorithm.","enum":["drand-hkdf-sha256-v1"],"type":"string"},"client_seed":{"default":"","description":"Optional public domain-separation label, not secret entropy.","maxLength":256,"type":"string"},"items":{"description":"Strings to permute, at most 131072 UTF-8 bytes combined; duplicate values are allowed and remain distinguishable by original_indices.","items":{"maxLength":256,"type":"string"},"maxItems":1000,"minItems":2,"type":"array"},"target_round":{"default":0,"description":"0 asks the server to choose the next safe unpublished round; a positive value makes a client_fixed commitment and must still be safely in the future.","minimum":0,"type":"integer"}},"required":["items"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"description":"Verifiable Random result and complete drand derivation transcript.","properties":{"algorithm_version":{"description":"Pinned canonicalization, derivation, and sampling algorithm version required to reproduce the result.","enum":["drand-hkdf-sha256-v1"],"type":"string"},"beacon":{"additionalProperties":false,"description":"Locally verified drand Quicknet proof used as the public randomness source.","properties":{"chain_hash":{"description":"Pinned Quicknet chain hash used to fetch and verify the round.","enum":["52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971"],"type":"string"},"network":{"description":"Pinned drand network name.","enum":["quicknet"],"type":"string"},"randomness":{"description":"Lowercase hexadecimal randomness derived from the verified signature.","pattern":"^[0-9a-f]{64}$","type":"string"},"round":{"description":"Exact verified Quicknet round used for this result.","minimum":1,"type":"integer"},"scheduled_time":{"description":"Scheduled UTC publication time of the selected round.","format":"date-time","type":"string"},"scheme":{"description":"Pinned drand signature scheme.","enum":["bls-unchained-g1-rfc9380"],"type":"string"},"signature":{"description":"Lowercase hexadecimal BLS signature verified against the pinned Quicknet public key.","pattern":"^[0-9a-f]{96}$","type":"string"}},"required":["network","chain_hash","scheme","round","scheduled_time","randomness","signature"],"type":"object"},"example_only":{"description":"True only in compiled catalog/keepalive examples; live paid results are false.","type":"boolean"},"operation":{"description":"Random operation performed by this route.","enum":["shuffle"],"type":"string"},"processed_at":{"description":"UTC time when the service accepted the request and committed to the round-selection decision.","format":"date-time","type":"string"},"request_hash":{"description":"Lowercase SHA-256 of your canonical request JSON — retain the exact request body so you can re-derive the result offline.","pattern":"^[0-9a-f]{64}$","type":"string"},"result":{"additionalProperties":false,"description":"Operation-specific result derived deterministically from the verified beacon and request hash.","properties":{"items":{"description":"Input strings in their derived shuffled order.","items":{"type":"string"},"type":"array"},"original_indices":{"description":"For each output position, the zero-based index of that value in the input array.","items":{"type":"integer"},"type":"array"}},"required":["items","original_indices"],"type":"object"},"selection_mode":{"description":"server_next means the server chose the next safe unpublished round, so you trust its selection chronology; client_fixed means the round is the one you committed to before paying and no other round can be substituted; example_only appears only in catalog examples.","enum":["server_next","client_fixed","example_only"],"type":"string"},"target_round":{"description":"Echoes the round actually selected for this result; in server_next mode this is the server-chosen round, not the 0 you sent.","minimum":1,"type":"integer"}},"required":["operation","algorithm_version","selection_mode","target_round","example_only","processed_at","request_hash","beacon","result"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":599,"error":null}],"description_full":"Verifiable Random shuffle — a uniform Fisher-Yates permutation bound to a future drand round the server waits for (typically 3-6s) and verifies locally, with original indices and a reproducible proof transcript.","last_updated":"2026-09-15T06:32:18.852Z","schemes":["exact"]}