bankrbot/darksol-random-oracle
darksol-random-oracle/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add bankrbot/openclaw-skills darksol-random-oracleInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 3:28 AM141.5s1 file scanned
SKILL.md
- name:
- 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.
- category:
- oracle
- chains:
- [base]
- homepage:
- https://acp.darksol.net/oracle
- apiBase:
- https://acp.darksol.net/oracle
- payment:
- x402-usdc-base
- 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
bankrbot/1claw
tools
VerifiedTrustedCommunity
HSM-backed secret management for AI agents. Store API keys (including Bankr `bk_` keys), passwords, and credentials in an encrypted vault; retrieve them at runtime via MCP without keeping secrets in chat context. Policy-based access control, secret rotation, sharing, EVM transaction intents (sign/simulate/broadcast), multi-chain signing keys, treasury multisig proposals, OIDC federation for external service auth, built-in prompt injection detection, and optional Shroud TEE LLM proxy. Use when the agent needs secure credential storage, just-in-time secret access, guarded on-chain signing, or security scanning — not for Bankr trading prompts, portfolio checks, or x402 calls (use the bankr skill instead).
1,144SKILL.mdUpdated Jun 5, 2026
bankrbot/gem-miner
testing
VerifiedTrustedCommunity
Stake $GEM tokens on Gem Miner (gemminer.app) to earn yield and unlock the in-game earn/cashout system. Use when the user wants to stake GEM, check their staking balance or rewards, unstake, claim rewards, or check whether they meet the 25M GEM gate. Base mainnet only.
1,143SKILL.mdUpdated Jun 1, 2026
bankrbot/codegrid
development
VerifiedTrustedCommunity
CodeGrid is a native macOS canvas where multiple coding agents (Claude, Codex, Gemini, Cursor, Grok, shells) run side by side in panes and collaborate via a local agent bus — no tmux, no cloud, no account, no stored API keys. Install this skill when an agent should know how to operate inside a CodeGrid pane, drive the workspace from outside (control socket or codegrid:// deep links), spawn or message sibling agents, or coordinate multi-agent work (delegate, review, pipeline, parallel fan-out, monitor, debate). The differentiator: multiple coding agents collaborating on one canvas, addressable by stable session_id, with a read → message → read protocol built for orchestration.
1,143SKILL.mdUpdated Jun 1, 2026
bankrbot/agent-wormhole
tools
VerifiedTrustedCommunity
Use Agent Wormhole for one-time sealed handoffs between autonomous agents, including encrypted mission briefs, scoped secrets, temporary artifacts, receipts, config drops, CLI/API usage, ECHO holder access, and Bankr x402 paid opens.
1,143SKILL.mdUpdated Jun 1, 2026