{"uid":"cap_ag9r3vTdCe5Do1kSoHHVD","slug":"forgemesh-hmac-random-draw-2f128d25","name":"ForgeMesh HMAC Random Draw","description":"Cryptographic random number draw with a revealed server seed for after-the-fact verification: combine it with your own client seed to get a number in your chosen range that neither party could have predicted or manipulated in advance. For games, sampling, and fair-assignment logic between untrusted parties.","url":"https://x402.forgemesh.io/hmac-random-draw","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"max":{"type":"string","description":"default 100"},"min":{"type":"string","description":"default 1"},"client_seed":{"type":"string","description":"your seed for verifiability"}}},"responseSchema":{"type":"json","example":{"proof":"HMAC-SHA256(server_seed, client_seed) first 4 bytes mod range — recompute to verify","value":4,"server_seed_revealed":"e3b1..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yk7uU6RMEB7WVsZH9o38t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a cryptographically fair random number in a user-specified range using a revealed server seed combined with a client seed, enabling provably fair, verifiable randomness.","exampleAgentPrompt":"Give me a provably fair random number between 1 and 50 using my client seed 'sunset-42-phoenix' — I need the server seed revealed afterward so I can verify the draw was honest.","exampleUseCases":null,"resultDescription":"Returns a random number within the requested min/max range, along with the server seed used in the HMAC computation, so the caller can independently verify the result by combining the server seed with their client seed and confirming the output matches.","failureModes":["Invalid min/max range (e.g. min >= max) returns a 400 error","Missing or malformed client_seed may produce unverifiable results","Payment failure via x402 protocol blocks the request","Server-side seed generation failure returns a 500 error"],"whenToPreferThis":"Choose this endpoint when you need randomness that is verifiably fair to all parties — neither the server nor the client could have predicted or biased the result in advance. Ideal for games, lotteries, random sampling, or fair assignment logic between untrusted participants. Prefer over a simple random number generator when auditability and provability of fairness are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:02:30.081Z","isFirstParty":false}