magicblock_requestRandomness
InactiveTool of SAP MCP Server
Request provably fair on-chain randomness from the MagicBlock VRF oracle (Vrf1RNUjXmQGjmQrQLvJHs9SNkvDJEsRVFPkfSQUwGz). Builds an unsigned transaction that invokes request_randomness on the VRF program. Use sap_preview_transaction, sap_sign_transaction, and sap_submit_signed_transaction; do not create local signing scripts. The oracle queue defaults to the base-layer queue (Cuj97ggrhhidhbu39TijNVqE74xvKJ69gDervRUXAxGh); set ephemeral=true to use the ER queue for delegated programs. Builder fee applies.
Parameters schema
{
"type": "object",
"required": [
"payer",
"callbackProgramId",
"callbackDiscriminator",
"callerSeed",
"callbackAccounts"
],
"properties": {
"payer": {
"type": "string",
"description": "Wallet pubkey that will pay for the request and sign the transaction"
},
"endpoint": {
"enum": [
"mainnet",
"devnet"
],
"type": "string",
"description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
},
"ephemeral": {
"type": "boolean",
"description": "Use the Ephemeral Rollup oracle queue instead of the base-layer queue (default false)"
},
"callerSeed": {
"type": "string",
"description": "Seed string for the VRF request — committed before randomness is produced. The seed is hashed to 32 bytes."
},
"callbackAccounts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"pubkey": {
"type": "string",
"description": "Account pubkey"
},
"isSigner": {
"type": "boolean",
"description": "Whether the account is a signer"
},
"isWritable": {
"type": "boolean",
"description": "Whether the account is writable"
}
},
"description": "Callback account metadata"
},
"description": "Accounts to pass to the callback instruction"
},
"callbackProgramId": {
"type": "string",
"description": "Program ID of the callback program (the program that will consume the randomness)"
},
"callbackDiscriminator": {
"type": "string",
"description": "Base58 or hex discriminator for the callback instruction in your program"
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
SAP MCP Server
https://github.com/OOBE-PROTOCOL/sap-mcp
2/7 registries