Oracle Aléatoire DARKSOL

Aléatoire vérifiable on-chain pour les agents, jeux, tirages au sort, simulations et applications.

Bankr peut utiliser cette compétence quand un utilisateur demande des nombres aléatoires équitables, des lancers de pièce, des lancers de dés, des mélanges, des gagnants de cadeaux, des résultats de butin, ou toute forme d'aléatoire qui doit être publiquement vérifiable.

Service

• UI: https://acp.darksol.net/oracle
• API base: https://acp.darksol.net/oracle
• Chain: Base 8453
• Contrat oracle: 0x4d2f471ae67b129bAda9cfC6224f0343c5C8fB5D
• Token DARKSOL: 0x00cb1fbca324d51325a7264d54072bc073c28ba3
• Token de paiement x402: USDC sur Base 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• x402 payer à: 0x8f9fa2bfd50079c1767d63effbfe642216bfcb01

Quand l'utiliser

Utilisez cette compétence pour:

• lancers de pièce
• lancers de dés
• entiers aléatoires
• séquences aléatoires
• mélanger une liste
• sélection de gagnants de tirage au sort ou cadeau
• tables de butin et résultats de jeux
• graines de simulation
• mécaniques de casino/jeux nécessitant un RNG vérifiable
• workflows d'agents nécessitant de l'aléatoire soutenu par une preuve avec reçu de transaction Base

N'utilisez pas cette compétence pour la génération de clé privée, la génération de seed de portefeuille, les mots de passe, les nonces cryptographiques, ou les secrets. L'oracle retourne de l'aléatoire public vérifiable, pas de l'entropie privée.

Modèle d'accès

Accès gratuit pour détenteurs DARKSOL

Si l'appelant contrôle un portefeuille détenant au moins 10 000 000 DARKSOL sur Base, les appels sont gratuits.

L'appelant signe ce message exact, en remplaçant l'adresse du portefeuille:

DARKSOL Oracle free access
Wallet: 0xYourAgentWallet
Chain: Base (8453)
Purpose: prove token-holder access without payment

Envoyez les en-têtes de preuve:

x-darksol-wallet: 0xYourAgentWallet
x-darksol-signature: 0xSignature

Accès payant x402

Sans preuve de détenteur valide, les endpoints de l'oracle nécessitent un paiement x402:

• endpoints basiques: $0,05 USDC sur Base
• endpoints premium: $0,25 USDC sur Base

Une requête non authentifiée normale retourne HTTP 402 avec les exigences de paiement. Payez via un client compatible x402, puis réessayez avec l'en-tête de paiement x402.

Endpoints

Health

GET https://acp.darksol.net/oracle/health

Retourne la santé, le contrat, le numéro de bloc, les tarifs et les détails d'accès gratuit.

Nombre Aléatoire

GET https://acp.darksol.net/oracle/random/number?min=1&max=100

Params:

• min: entier, défaut 1
• max: entier, défaut 10

Prix: $0,05 ou gratuit pour les détenteurs DARKSOL éligibles.

Lancer de Pièce

GET https://acp.darksol.net/oracle/random/coin

Retourne heads ou tails.

Prix: $0,05 ou gratuit pour les détenteurs DARKSOL éligibles.

Lancer de Dé

GET https://acp.darksol.net/oracle/random/dice?sides=20&count=3

Params:

• sides: entier 2..1000, défaut 6
• count: entier 1..100, défaut 2

Prix: $0,05 ou gratuit pour les détenteurs DARKSOL éligibles.

Séquence Aléatoire

GET https://acp.darksol.net/oracle/random/sequence?count=6&min=1&max=49

Params:

• count: entier 1..100, défaut 5
• min: entier, défaut 1
• max: entier, défaut 50

Prix: $0,25 ou gratuit pour les détenteurs DARKSOL éligibles.

Shuffle

GET https://acp.darksol.net/oracle/random/shuffle?items=alice,bob,carol,dave

Params:

• items: liste séparée par des virgules avec au moins 2 éléments

Prix: $0,25 ou gratuit pour les détenteurs DARKSOL éligibles.

Forme de Réponse

{
  "result": 77,
  "access": {
    "mode": "x402_settled",
    "paymentRequired": true
  },
  "proof": {
    "txHash": "0x...",
    "blockNumber": 45168397,
    "contract": "0x4d2f471ae67b129bAda9cfC6224f0343c5C8fB5D",
    "chain": "base",
    "chainId": 8453
  },
  "timestamp": "2026-04-25T14:09:01.905Z"
}

Toujours afficher le proof.txHash en rapportant les résultats à un utilisateur. C'est la piste d'audit.

Si l'endpoint retourne HTTP 202 avec status: "pending", le paiement s'est réglé mais la confirmation de l'oracle a dépassé la fenêtre de requête. Afficher access.payment.transaction comme preuve de paiement et pending.txHash comme tx d'oracle à vérifier/réessayer sous peu. Ne pas soumettre un autre paiement juste parce que la réponse de l'oracle est en attente.

Exemples de Prompt Bankr

Use DARKSOL Random Oracle to roll 3 d20 dice and show me the Base proof tx.

Use DARKSOL Random Oracle to pick a giveaway winner from alice,bob,carol,dave. Return the shuffled list and proof hash.

Use DARKSOL Random Oracle to generate 6 lottery numbers from 1 to 49 and include the on-chain verification link.

Flip a verifiable coin using DARKSOL Random Oracle.

Procédure Agent

1. Analyser la requête utilisateur en un endpoint et des paramètres de query.
2. Préférer l'accès gratuit pour détenteur si l'utilisateur fournit un portefeuille et une signature.
3. Sinon utiliser le paiement x402 USDC sur Base.
4. Appeler l'endpoint.
5. Retourner le résultat plus le lien de la transaction de preuve: https://basescan.org/tx/<txHash>
6. Si l'endpoint retourne HTTP 402, compléter le flux de paiement x402 et réessayer.
7. Si l'endpoint retourne HTTP 202/status en attente, rapporter la tx de paiement et la tx d'oracle en attente; ne pas payer à nouveau.

Exemples Curl

curl https://acp.darksol.net/oracle/health

curl "https://acp.darksol.net/oracle/random/number?min=1&max=100"

curl "https://acp.darksol.net/oracle/random/dice?sides=20&count=3"

curl "https://acp.darksol.net/oracle/random/shuffle?items=alice,bob,carol,dave"

Notes de Sécurité

• Les résultats sont publics et vérifiables. Ne pas utiliser pour les secrets.
• Pour les jeux d'argent réglementés, vérifier les exigences juridictionnelles avant utilisation.
• Pour les applications sensibles à l'équité, conserver la tx de preuve retournée avec l'enregistrement d'application.

Construit avec conviction. 🌑