darksol-random-oracle
Bankr-compatible skill for DARKSOL Random Oracle, an on-chain verifiable RNG API on Base
Install / Use
npx skills add BankrBot/skills --skill darksol-random-oracleInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Customer SupportSupported Platforms
Our assessment of darksol-random-oracle
darksol-random-oracle scores 89/100 on our quality scale, 171st of 319 Customer Support skills we index.
Its SKILL.md is 6.0 KB long, well organised into 18 sections with 17 code examples: a thorough specification that gives an agent plenty to work with.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so darksol-random-oracle is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
darksol-random-oracle compared with similar skills
All 4 of these similar skills score higher than darksol-random-oracle; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| darksol-random-oracle (this skill)by BankrBot | 89 | 1.2k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install darksol-random-oracle?
- Run
npx skills add BankrBot/skills --skill darksol-random-oracle. The install tabs above show the steps for each supported agent. - Which AI agents does darksol-random-oracle work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is darksol-random-oracle safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is darksol-random-oracle still maintained?
- The repository was last updated about 2 months ago, so darksol-random-oracle is actively maintained.
Skill content
View source on GitHubname: darksol-random-oracle description: Bankr-compatible skill for DARKSOL Random Oracle, an on-chain verifiable RNG API on Base. Use when an agent needs random numbers, coin flips, dice rolls, random sequences, shuffles, raffles, loot drops, games, simulations, casino mechanics, or auditable randomness. Supports DARKSOL holder free access and x402 USDC payments on Base. metadata: bankr: category: oracle chains: [base] homepage: https://acp.darksol.net/oracle apiBase: https://acp.darksol.net/oracle payment: x402-usdc-base openclaw: emoji: "🎲"
DARKSOL Random Oracle
On-chain verifiable randomness for agents, games, raffles, simulations, and apps.
Bankr can use this skill when a user asks for fair random numbers, coin flips, dice rolls, shuffles, giveaway winners, loot outcomes, or any randomness that should be publicly auditable.
Service
- UI:
https://acp.darksol.net/oracle - API base:
https://acp.darksol.net/oracle - Chain: Base
8453 - Oracle contract:
0x4d2f471ae67b129bAda9cfC6224f0343c5C8fB5D - DARKSOL token:
0x00cb1fbca324d51325a7264d54072bc073c28ba3 - x402 payment token: USDC on Base
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 - x402 pay-to:
0x8f9fa2bfd50079c1767d63effbfe642216bfcb01
When To Use
Use this skill for:
- coin flips
- dice rolls
- random integers
- random sequences
- shuffling a list
- raffle or giveaway winner selection
- loot tables and game outcomes
- simulation seeds
- casino/game mechanics that need verifiable RNG
- agent workflows that need proof-backed randomness with a Base transaction receipt
Do not use this skill for private key generation, wallet seed generation, passwords, cryptographic nonces, or secrets. The oracle returns public verifiable randomness, not private entropy.
Access Model
DARKSOL Holder Free Access
If the caller controls a wallet holding at least 10,000,000 DARKSOL on Base, calls are free.
The caller signs this exact message, replacing the wallet address:
DARKSOL Oracle free access
Wallet: 0xYourAgentWallet
Chain: Base (8453)
Purpose: prove token-holder access without payment
Send the proof headers:
x-darksol-wallet: 0xYourAgentWallet
x-darksol-signature: 0xSignature
x402 Paid Access
Without a valid holder proof, oracle endpoints require x402 payment:
- basic endpoints:
$0.05USDC on Base - premium endpoints:
$0.25USDC on Base
A normal unauthenticated request returns HTTP 402 with payment requirements. Pay using an x402-compatible client, then retry with the x402 payment header.
Endpoints
Health
GET https://acp.darksol.net/oracle/health
Returns health, contract, block number, pricing, and free-access details.
Random Number
GET https://acp.darksol.net/oracle/random/number?min=1&max=100
Params:
min: integer, default1max: integer, default10
Price: $0.05 or free for eligible DARKSOL holders.
Coin Flip
GET https://acp.darksol.net/oracle/random/coin
Returns heads or tails.
Price: $0.05 or free for eligible DARKSOL holders.
Dice Roll
GET https://acp.darksol.net/oracle/random/dice?sides=20&count=3
Params:
sides: integer2..1000, default6count: integer1..100, default2
Price: $0.05 or free for eligible DARKSOL holders.
Random Sequence
GET https://acp.darksol.net/oracle/random/sequence?count=6&min=1&max=49
Params:
count: integer1..100, default5min: integer, default1max: integer, default50
Price: $0.25 or free for eligible DARKSOL holders.
Shuffle
GET https://acp.darksol.net/oracle/random/shuffle?items=alice,bob,carol,dave
Params:
items: comma-separated list with at least 2 items
Price: $0.25 or free for eligible DARKSOL holders.
Response Shape
{
"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"
}
Always surface the proof.txHash when reporting results to a user. That is the audit trail.
If the endpoint returns HTTP 202 with status: "pending", payment has settled but oracle confirmation exceeded the request window. Surface access.payment.transaction as the payment proof and pending.txHash as the oracle tx to check/retry shortly. Do not submit another payment just because the oracle response is pending.
Bankr Prompt Examples
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.
Agent Procedure
- Parse the user request into one endpoint and query params.
- Prefer holder-free access if the user provides a wallet and signature.
- Otherwise use x402 USDC payment on Base.
- Call the endpoint.
- Return the result plus the proof transaction link:
https://basescan.org/tx/<txHash> - If the endpoint returns HTTP 402, complete the x402 payment flow and retry.
- If the endpoint returns HTTP 202/status pending, report the payment tx and pending oracle tx; do not pay again.
Curl Examples
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"
Safety Notes
- Results are public and verifiable. Do not use for secrets.
- For regulated gambling, check jurisdictional requirements before use.
- For fairness-sensitive apps, store the returned proof tx with the application record.
Built with teeth. 🌑
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
