[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M720Y3D485Q7F77SXNRT3VDP":3,"skill-same:01M720Y3D485Q7F77SXNRT3VDP":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M720Y3D485Q7F77SXNRT3VDP","bastion-how-to-use",null,"Guides agent developers on integrating Bastion (Programmable Trust Runtime). Covers SDK usage (BastionClient), REST API endpoints (\u002Fsimulate, \u002Fpolicy, \u002Foverride, \u002Flogs), interpreting audit logs and simulation results, configuring policy rules (allowlists, SOL caps, rate limits, blockint security checks), on-chain program interaction (audit trail, agent registry, circuit breaker), and deployment. Use when the user asks about integrating an AI agent with Bastion, sending transactions through the trust runtime, configuring security policies, reading audit trails, or deploying Bastion alongside autonomous agents.","zkos-labs\u002Fbastion","zkos-labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F263369112?v=4","01M720WZH0GD7FAKBP5PSGF4TG","ZKOS Labs","01M720WZHP9JV5NZVQCHA6XJ3M",3,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbastion-how-to-use\u002FSKILL.md",[],[],"2026-11-10 18:39:20",false,"---\nname: bastion-how-to-use\ndescription: Guides agent developers on integrating Bastion (Programmable Trust Runtime). Covers SDK usage (BastionClient), REST API endpoints (\u002Fsimulate, \u002Fpolicy, \u002Foverride, \u002Flogs), interpreting audit logs and simulation results, configuring policy rules (allowlists, SOL caps, rate limits, blockint security checks), on-chain program interaction (audit trail, agent registry, circuit breaker), and deployment. Use when the user asks about integrating an AI agent with Bastion, sending transactions through the trust runtime, configuring security policies, reading audit trails, or deploying Bastion alongside autonomous agents.\n---\n\n# Bastion - How to Use (Agent Developer Guide)\n\nBastion is a **Programmable Trust Runtime** (Axum sidecar + on-chain audit programs) that sits between AI agents and their execution environments. Open-source community project developed by ZKOS Labs. Every action an agent intends to take passes through Bastion first: identity verification, policy evaluation, simulation, optionally human review, then either execute or block. Every decision recorded as a verifiable audit record.\n\nThis skill covers what an agent developer needs to integrate with Bastion.\n\n## Architecture Overview\n\n```\nAgent → Bastion REST API → Policy Engine → Helius Simulation → On-chain Audit → Sign or Block\n         ↑───────────────────────────────────────────────────────────────┘ (async)\n```\n\nBastion runs as a local HTTP server (default `https:\u002F\u002Fbastion-agentique.fly.dev\u002F`). Agents send transaction payloads to `\u002Fsimulate` and receive a decision (ALLOW, BLOCK, or PENDING_APPROVAL).\n\n## Quick Start: Agent Integration Flow\n\n1. Start Bastion server (see README)\n2. **Register your agent identity** via `POST \u002Fagents` (NEW in v0.3.0)\n3. Configure policy (whitelist programs, set SOL caps, enable blockint checks)\n4. Send transactions to `POST \u002Fsimulate` before signing\n5. If allowed, sign and send the transaction\n6. If blocked, request human override via `POST \u002Foverride`\n7. Monitor audit logs via `GET \u002Flogs`\n\n## Agent Identity & Self-Registration (v0.3.0)\n\n**Every AI agent MUST register with Bastion before sending transactions.** Registration gives you a W3C DID, tracks your audit trail, and enables delegation of sub-agents.\n\n### Register (first time)\n\n```bash\ncurl -s -X POST https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"did\": \"did:bastion:solana:YOUR_AGENT_PDA_BASE58\",\n    \"authority_pubkey\": \"YOUR_SOLANA_PUBKEY_BASE58\",\n    \"sidecar_endpoint\": null\n  }'\n```\n\n**If BASTION_API_KEY is set** (you get 401), add: `-H \"X-Api-Key: YOUR_KEY\"`\n\n### Verify\n\n```bash\ncurl -s https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents | python3 -m json.tool\n```\n\n### Spawn sub-agent (delegation)\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents\u002Fdid:bastion:solana:PARENT_DID\u002Fdelegate\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"child_did\": \"did:bastion:solana:CHILD_DID\",\n    \"child_name\": \"SubAgent-ETH\",\n    \"delegated_capabilities\": [\"TRANSFER\"]\n  }'\n```\n\n### See your delegation tree\n\n```bash\ncurl -s \"https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents\u002Fdid:bastion:solana:DID\u002Ftree\" | python3 -m json.tool\n```\n\n### Agent Registry API\n\n| Method | Path | Auth | Purpose |\n|--------|------|------|---------|\n| POST | `\u002Fagents` | Yes | Register agent (with optional parent_did for delegation) |\n| GET | `\u002Fagents` | No | List all registered agents |\n| GET | `\u002Fagents\u002F:did` | No | Single agent detail |\n| GET | `\u002Fagents\u002F:did\u002Faudit` | No | Agent-specific audit trail |\n| GET | `\u002Fagents\u002F:did\u002Fchildren` | No | List sub-agents |\n| GET | `\u002Fagents\u002F:did\u002Ftree` | No | Full delegation tree |\n| POST | `\u002Fagents\u002F:did\u002Fdelegate` | Yes | Spawn sub-agent |\n| DELETE | `\u002Fagents\u002F:did\u002Fdelegation\u002F:child_did` | Yes | Revoke delegation |\n| GET | `\u002Fagents\u002F:did\u002Fstake` | No | Agent stake status |\n\n## REST API Reference\n\n### `POST \u002Fsimulate` - Validate a transaction\n\nRequest:\n```json\n{\n  \"transaction\": \"base64_encoded_serialized_transaction\",\n  \"intent\": \"human-readable description of what the agent intends to do\"\n}\n```\n\nResponse `200 ALLOWED`:\n```json\n{\n  \"decision\": \"ALLOW\",\n  \"units_consumed\": 150000,\n  \"balance_changes\": {\"wallet_pubkey\": -1000000000},\n  \"block_id\": null\n}\n```\n\nResponse `403 BLOCKED`:\n```json\n{\n  \"error\": \"Blockint: flash-loan pattern detected on account ...\",\n  \"decision\": \"BLOCK\",\n  \"block_id\": \"uuid-for-override\"\n}\n```\n\nThe `intent` field is logged alongside the decision for later audit review.\n\n### `POST \u002Foverride` - Human override for blocked transactions\n\n```json\n{\n  \"block_id\": \"uuid-from-blocked-response\",\n  \"action\": \"ALLOW\"\n}\n```\n\nActions: `ALLOW` or `REJECT`.\n\n### `GET \u002Flogs` - Fetch audit logs\n\n```\nGET \u002Flogs?limit=10&offset=0&result=BLOCKED\n```\n\nQuery params: `limit` (default 50), `offset`, `result` (ALLOWED\u002FBLOCKED\u002FPENDING_APPROVAL).\n\nReturns:\n```json\n{\n  \"total\": 142,\n  \"offset\": 0,\n  \"limit\": 10,\n  \"entries\": [\n    {\n      \"id\": \"...\",\n      \"transaction_id\": \"...\",\n      \"signature\": null,\n      \"decision\": \"BLOCKED\",\n      \"reason\": \"Blockint: flash-loan pattern detected on account ...\",\n      \"block_id\": \"uuid\",\n      \"timestamp\": 1715000000,\n      \"intent\": \"Swap 1 SOL for USDC\"\n    }\n  ]\n}\n```\n\n### `GET \u002Flogs\u002Ftx\u002F:transaction_id` - Lookup by transaction hash\n\n### `GET \u002Flogs\u002Fsignature\u002F:signature` - Lookup by on-chain signature\n\n### `GET \u002Fpolicy` - Current policy settings\n\n### `PUT \u002Fpolicy` - Update core policy\n\n```json\n{\n  \"max_sol_per_tx\": 1,\n  \"max_balance_drain_lamports\": 100000000,\n  \"rate_limit_per_minute\": 10,\n  \"simulation_checks_enabled\": true,\n  \"allowed_programs\": [\"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\"],\n  \"blocked_addresses\": []\n}\n```\n\n### `PUT \u002Fpolicy\u002Ffull` - Full policy update including blockint rules\n\nAll fields from `\u002Fpolicy` plus:\n```json\n{\n  \"blockint_flash_loan_check\": true,\n  \"blockint_high_slippage_check\": true,\n  \"blockint_mint_authority_blocked\": true,\n  \"blockint_freeze_authority_blocked\": true,\n  \"blockint_max_slippage_bps\": 500,\n  \"blockint_risk_labeled_addresses\": []\n}\n```\n\n### Circuit breaker endpoints\n\n- `GET \u002Fcircuit-breaker\u002Fstatus` - Returns `{ engaged: true\u002Ffalse }`\n- `POST \u002Fcircuit-breaker\u002Fengage` - Pauses all transaction processing (also calls `emergencyPause` on-chain if configured)\n- `POST \u002Fcircuit-breaker\u002Fdisengage` - Resumes (calls `emergencyResume` on-chain)\n\n### `GET \u002Fhealth` - Health check (returns `\"Hello, Bastion!\"`)\n\n## Policy Configuration\n\n### Program Allowlist\n\nBy default all programs are allowed (empty allowlist). Once you add entries, only whitelisted programs are permitted:\n\n```\nallowed_programs = [\n  \"11111111111111111111111111111111\",    \u002F\u002F System Program\n  \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",  \u002F\u002F Token Program\n  \"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\",   \u002F\u002F Jupiter v6\n  \"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8\",   \u002F\u002F Raydium\n]\n```\n\n### Blockint Security Checks (from Daemon Blockint Tech)\n\n- **Flash loan detection**: Flags accounts with near-equal large inflow\u002Foutflow (ratio threshold configurable, default 100x)\n- **High slippage**: Flags effective slippage exceeding max bps (default 500 = 5%)\n- **Mint authority changes**: Blocks token mint authority transfers\n- **Freeze authority changes**: Blocks token freeze authority transfers\n- **Risk-labeled addresses**: Blocks transactions involving known-risk addresses\n\n### Simulation Checks\n\n- `NoErrorCheck`: Transaction must simulate without errors\n- `MaxUnitsCheck`: Compute units must be under 1,400,000\n- `MaxBalanceDrainCheck`: Total outflow must not exceed configured lamport limit\n\n## On-Chain Program Integration\n\nProgram ID: `A29V5MUVs73y7XBHHxPpPcAW7h4gGHupbDdwYSwA2n9D`\n\n### Instructions\n\n| Instruction | Description |\n|---|---|\n| `initialize` | Initialize audit state (called once by authority) |\n| `logAudit` | Record a decision (0=Allowed, 1=Blocked, 2=Pending) with simulation hash and reasoning |\n| `registerAgent` | Register an agent identity with capability bitmask |\n| `updateAgentReputation` | Adjust an agent's on-chain reputation score |\n| `setPolicy` | Commit allowed programs, SOL cap, and rate limit on-chain |\n| `emergencyPause` | Pause the protocol (circuit breaker) |\n| `emergencyResume` | Resume the protocol |\n| `stakeLamports` | Stake SOL for higher transaction limits (48h min before unstake) |\n| `requestUnstake` | Start 7-day unstake cooldown |\n| `claimUnstake` | Claim SOL after cooldown expires |\n\n### On-Chain Configuration\n\nBastion submits audit entries on-chain asynchronously (fire-and-forget). Enable with env vars:\n```\nBASTION_ON_CHAIN=1\nSOLANA_RPC_URL=https:\u002F\u002Fapi.devnet.solana.com\nBASTION_KEYPAIR_PATH=.\u002Fkeypair.json\n```\n\nWhen disabled (default), audit entries are local-only (Sled DB) and circuit breaker is API-only.\n\n## TypeScript SDK\n\n```typescript\nimport { BastionClient, BASTION_PROGRAM_ID } from \"@zkos-labs\u002Fbastion-agentique\";\nimport { Connection, Keypair } from \"@solana\u002Fweb3.js\";\n\nconst client = new BastionClient({\n  connection: new Connection(\"https:\u002F\u002Fapi.devnet.solana.com\")\n});\n\nconst wallet = Keypair.generate();\n\n\u002F\u002F Register agent on-chain\nawait client.registerAgent(wallet, \"MyTradingBot\", 3);\n\n\u002F\u002F Set on-chain policy\nconst jupiterProgram = new PublicKey(\"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\");\nawait client.setPolicy(wallet, [jupiterProgram], 5, 10);\n\n\u002F\u002F Fetch audit state\nconst state = await client.fetchAuditState();\n\n\u002F\u002F Emergency pause\nawait client.emergencyPause(wallet);\n```\n\n## Understanding Audit Logs\n\nEach log entry contains:\n- `decision`: ALLOWED, BLOCKED, or PENDING_APPROVAL\n- `reason`: Why it was blocked (policy violation, simulation error, blockint rule)\n- `block_id`: UUID for use with `\u002Foverride` (only for BLOCKED\u002FPENDING_APPROVAL)\n- `intent`: Human-readable description from the agent\n- `transaction_id`: Hash of the transaction payload\n- `signature`: On-chain signature (populated after async on-chain submission)\n- `timestamp`: Unix timestamp\n\n## Deployment\n\n### Docker (quick start)\n```bash\ndocker-compose up --build\n```\n\n### Manual\n```bash\ncargo build --release\nHELIUS_API_KEY=your_key BASTION_ON_CHAIN=1 cargo run --release\n```\n\n### On-chain program\n```bash\ncd programs\u002Fbastion-audit\nanchor build\nanchor deploy --provider.cluster devnet\n```\n\n## MCP HTTP Server (SSE)\n\nStart the MCP server for browser-native SSE access:\n\n```bash\nBASTION_SIDECAR_URL=https:\u002F\u002Fbastion-agentique.fly.dev\u002F \\\npnpm --filter @zkos-labs\u002Fmcp-server dev:http\n```\n\nEndpoints:\n- `GET \u002Fmcp\u002Fsse` - SSE connection\n- `POST \u002Fmcp\u002Fmessages` - MCP JSON-RPC messages (with `?sessionId=\u003Cid>`)\n- `GET \u002Fmcp\u002Fhealth` - Health check\n- `GET \u002Fmcp\u002Fpricing` - Tool pricing + free tier info\n\n**15 tools** (same as stdio MCP): simulate, ingest, get\u002Fupdate policy, audit logs\u002Fstats, override, pending, circuit breaker, cases, DID, token balances.\n\n**3 prompts:** `bastion_verify_transaction`, `bastion_security_review`, `bastion_incident_response`.\n\n## Pricing\n\nBastion is an open-source community project, released under Apache 2.0. Read operations always free. Backend API calls optionally paid via USDT\u002FUSDC:\n\n| Tool | Free\u002FMonth | Price (USD) |\n|------|-----------|-------------|\n| `bastion_simulate_transaction` | 100 | $0.10 |\n| `bastion_override_block` | 10 | $1.00 |\n| `bastion_update_policy` | 5 | $5.00 |\n| `bastion_circuit_breaker_toggle` | 3 | $10.00 |\n\n## CORS\n\n```\nAccess-Control-Allow-Origin: *\nAccess-Control-Allow-Headers: Content-Type, Authorization, X-Api-Key, X-Agent-Id\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\n```\n\n## Related Skills\n\n- **blockchain-intelligence-playbook** - Broader blockchain investigation methodology\n- **solana-onchain-intelligence-resources** - Solana-specific tools and data sources\n- **defi-security-audit-agent** - DeFi security patterns that complement Bastion policy rules\n","# Bastion - How to Use (Agent Developer Guide)\n\nBastion is a **Programmable Trust Runtime** (Axum sidecar + on-chain audit programs) that sits between AI agents and their execution environments. Open-source community project developed by ZKOS Labs. Every action an agent intends to take passes through Bastion first: identity verification, policy evaluation, simulation, optionally human review, then either execute or block. Every decision recorded as a verifiable audit record.\n\nThis skill covers what an agent developer needs to integrate with Bastion.\n\n## Architecture Overview\n\n```\nAgent → Bastion REST API → Policy Engine → Helius Simulation → On-chain Audit → Sign or Block\n         ↑───────────────────────────────────────────────────────────────┘ (async)\n```\n\nBastion runs as a local HTTP server (default `https:\u002F\u002Fbastion-agentique.fly.dev\u002F`). Agents send transaction payloads to `\u002Fsimulate` and receive a decision (ALLOW, BLOCK, or PENDING_APPROVAL).\n\n## Quick Start: Agent Integration Flow\n\n1. Start Bastion server (see README)\n2. **Register your agent identity** via `POST \u002Fagents` (NEW in v0.3.0)\n3. Configure policy (whitelist programs, set SOL caps, enable blockint checks)\n4. Send transactions to `POST \u002Fsimulate` before signing\n5. If allowed, sign and send the transaction\n6. If blocked, request human override via `POST \u002Foverride`\n7. Monitor audit logs via `GET \u002Flogs`\n\n## Agent Identity & Self-Registration (v0.3.0)\n\n**Every AI agent MUST register with Bastion before sending transactions.** Registration gives you a W3C DID, tracks your audit trail, and enables delegation of sub-agents.\n\n### Register (first time)\n\n```bash\ncurl -s -X POST https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"did\": \"did:bastion:solana:YOUR_AGENT_PDA_BASE58\",\n    \"authority_pubkey\": \"YOUR_SOLANA_PUBKEY_BASE58\",\n    \"sidecar_endpoint\": null\n  }'\n```\n\n**If BASTION_API_KEY is set** (you get 401), add: `-H \"X-Api-Key: YOUR_KEY\"`\n\n### Verify\n\n```bash\ncurl -s https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents | python3 -m json.tool\n```\n\n### Spawn sub-agent (delegation)\n\n```bash\ncurl -s -X POST \"https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents\u002Fdid:bastion:solana:PARENT_DID\u002Fdelegate\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"child_did\": \"did:bastion:solana:CHILD_DID\",\n    \"child_name\": \"SubAgent-ETH\",\n    \"delegated_capabilities\": [\"TRANSFER\"]\n  }'\n```\n\n### See your delegation tree\n\n```bash\ncurl -s \"https:\u002F\u002Fbastion-agentique.fly.dev\u002F\u002Fagents\u002Fdid:bastion:solana:DID\u002Ftree\" | python3 -m json.tool\n```\n\n### Agent Registry API\n\n| Method | Path | Auth | Purpose |\n|--------|------|------|---------|\n| POST | `\u002Fagents` | Yes | Register agent (with optional parent_did for delegation) |\n| GET | `\u002Fagents` | No | List all registered agents |\n| GET | `\u002Fagents\u002F:did` | No | Single agent detail |\n| GET | `\u002Fagents\u002F:did\u002Faudit` | No | Agent-specific audit trail |\n| GET | `\u002Fagents\u002F:did\u002Fchildren` | No | List sub-agents |\n| GET | `\u002Fagents\u002F:did\u002Ftree` | No | Full delegation tree |\n| POST | `\u002Fagents\u002F:did\u002Fdelegate` | Yes | Spawn sub-agent |\n| DELETE | `\u002Fagents\u002F:did\u002Fdelegation\u002F:child_did` | Yes | Revoke delegation |\n| GET | `\u002Fagents\u002F:did\u002Fstake` | No | Agent stake status |\n\n## REST API Reference\n\n### `POST \u002Fsimulate` - Validate a transaction\n\nRequest:\n```json\n{\n  \"transaction\": \"base64_encoded_serialized_transaction\",\n  \"intent\": \"human-readable description of what the agent intends to do\"\n}\n```\n\nResponse `200 ALLOWED`:\n```json\n{\n  \"decision\": \"ALLOW\",\n  \"units_consumed\": 150000,\n  \"balance_changes\": {\"wallet_pubkey\": -1000000000},\n  \"block_id\": null\n}\n```\n\nResponse `403 BLOCKED`:\n```json\n{\n  \"error\": \"Blockint: flash-loan pattern detected on account ...\",\n  \"decision\": \"BLOCK\",\n  \"block_id\": \"uuid-for-override\"\n}\n```\n\nThe `intent` field is logged alongside the decision for later audit review.\n\n### `POST \u002Foverride` - Human override for blocked transactions\n\n```json\n{\n  \"block_id\": \"uuid-from-blocked-response\",\n  \"action\": \"ALLOW\"\n}\n```\n\nActions: `ALLOW` or `REJECT`.\n\n### `GET \u002Flogs` - Fetch audit logs\n\n```\nGET \u002Flogs?limit=10&offset=0&result=BLOCKED\n```\n\nQuery params: `limit` (default 50), `offset`, `result` (ALLOWED\u002FBLOCKED\u002FPENDING_APPROVAL).\n\nReturns:\n```json\n{\n  \"total\": 142,\n  \"offset\": 0,\n  \"limit\": 10,\n  \"entries\": [\n    {\n      \"id\": \"...\",\n      \"transaction_id\": \"...\",\n      \"signature\": null,\n      \"decision\": \"BLOCKED\",\n      \"reason\": \"Blockint: flash-loan pattern detected on account ...\",\n      \"block_id\": \"uuid\",\n      \"timestamp\": 1715000000,\n      \"intent\": \"Swap 1 SOL for USDC\"\n    }\n  ]\n}\n```\n\n### `GET \u002Flogs\u002Ftx\u002F:transaction_id` - Lookup by transaction hash\n\n### `GET \u002Flogs\u002Fsignature\u002F:signature` - Lookup by on-chain signature\n\n### `GET \u002Fpolicy` - Current policy settings\n\n### `PUT \u002Fpolicy` - Update core policy\n\n```json\n{\n  \"max_sol_per_tx\": 1,\n  \"max_balance_drain_lamports\": 100000000,\n  \"rate_limit_per_minute\": 10,\n  \"simulation_checks_enabled\": true,\n  \"allowed_programs\": [\"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\"],\n  \"blocked_addresses\": []\n}\n```\n\n### `PUT \u002Fpolicy\u002Ffull` - Full policy update including blockint rules\n\nAll fields from `\u002Fpolicy` plus:\n```json\n{\n  \"blockint_flash_loan_check\": true,\n  \"blockint_high_slippage_check\": true,\n  \"blockint_mint_authority_blocked\": true,\n  \"blockint_freeze_authority_blocked\": true,\n  \"blockint_max_slippage_bps\": 500,\n  \"blockint_risk_labeled_addresses\": []\n}\n```\n\n### Circuit breaker endpoints\n\n- `GET \u002Fcircuit-breaker\u002Fstatus` - Returns `{ engaged: true\u002Ffalse }`\n- `POST \u002Fcircuit-breaker\u002Fengage` - Pauses all transaction processing (also calls `emergencyPause` on-chain if configured)\n- `POST \u002Fcircuit-breaker\u002Fdisengage` - Resumes (calls `emergencyResume` on-chain)\n\n### `GET \u002Fhealth` - Health check (returns `\"Hello, Bastion!\"`)\n\n## Policy Configuration\n\n### Program Allowlist\n\nBy default all programs are allowed (empty allowlist). Once you add entries, only whitelisted programs are permitted:\n\n```\nallowed_programs = [\n  \"11111111111111111111111111111111\",    \u002F\u002F System Program\n  \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",  \u002F\u002F Token Program\n  \"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\",   \u002F\u002F Jupiter v6\n  \"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8\",   \u002F\u002F Raydium\n]\n```\n\n### Blockint Security Checks (from Daemon Blockint Tech)\n\n- **Flash loan detection**: Flags accounts with near-equal large inflow\u002Foutflow (ratio threshold configurable, default 100x)\n- **High slippage**: Flags effective slippage exceeding max bps (default 500 = 5%)\n- **Mint authority changes**: Blocks token mint authority transfers\n- **Freeze authority changes**: Blocks token freeze authority transfers\n- **Risk-labeled addresses**: Blocks transactions involving known-risk addresses\n\n### Simulation Checks\n\n- `NoErrorCheck`: Transaction must simulate without errors\n- `MaxUnitsCheck`: Compute units must be under 1,400,000\n- `MaxBalanceDrainCheck`: Total outflow must not exceed configured lamport limit\n\n## On-Chain Program Integration\n\nProgram ID: `A29V5MUVs73y7XBHHxPpPcAW7h4gGHupbDdwYSwA2n9D`\n\n### Instructions\n\n| Instruction | Description |\n|---|---|\n| `initialize` | Initialize audit state (called once by authority) |\n| `logAudit` | Record a decision (0=Allowed, 1=Blocked, 2=Pending) with simulation hash and reasoning |\n| `registerAgent` | Register an agent identity with capability bitmask |\n| `updateAgentReputation` | Adjust an agent's on-chain reputation score |\n| `setPolicy` | Commit allowed programs, SOL cap, and rate limit on-chain |\n| `emergencyPause` | Pause the protocol (circuit breaker) |\n| `emergencyResume` | Resume the protocol |\n| `stakeLamports` | Stake SOL for higher transaction limits (48h min before unstake) |\n| `requestUnstake` | Start 7-day unstake cooldown |\n| `claimUnstake` | Claim SOL after cooldown expires |\n\n### On-Chain Configuration\n\nBastion submits audit entries on-chain asynchronously (fire-and-forget). Enable with env vars:\n```\nBASTION_ON_CHAIN=1\nSOLANA_RPC_URL=https:\u002F\u002Fapi.devnet.solana.com\nBASTION_KEYPAIR_PATH=.\u002Fkeypair.json\n```\n\nWhen disabled (default), audit entries are local-only (Sled DB) and circuit breaker is API-only.\n\n## TypeScript SDK\n\n```typescript\nimport { BastionClient, BASTION_PROGRAM_ID } from \"@zkos-labs\u002Fbastion-agentique\";\nimport { Connection, Keypair } from \"@solana\u002Fweb3.js\";\n\nconst client = new BastionClient({\n  connection: new Connection(\"https:\u002F\u002Fapi.devnet.solana.com\")\n});\n\nconst wallet = Keypair.generate();\n\n\u002F\u002F Register agent on-chain\nawait client.registerAgent(wallet, \"MyTradingBot\", 3);\n\n\u002F\u002F Set on-chain policy\nconst jupiterProgram = new PublicKey(\"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\");\nawait client.setPolicy(wallet, [jupiterProgram], 5, 10);\n\n\u002F\u002F Fetch audit state\nconst state = await client.fetchAuditState();\n\n\u002F\u002F Emergency pause\nawait client.emergencyPause(wallet);\n```\n\n## Understanding Audit Logs\n\nEach log entry contains:\n- `decision`: ALLOWED, BLOCKED, or PENDING_APPROVAL\n- `reason`: Why it was blocked (policy violation, simulation error, blockint rule)\n- `block_id`: UUID for use with `\u002Foverride` (only for BLOCKED\u002FPENDING_APPROVAL)\n- `intent`: Human-readable description from the agent\n- `transaction_id`: Hash of the transaction payload\n- `signature`: On-chain signature (populated after async on-chain submission)\n- `timestamp`: Unix timestamp\n\n## Deployment\n\n### Docker (quick start)\n```bash\ndocker-compose up --build\n```\n\n### Manual\n```bash\ncargo build --release\nHELIUS_API_KEY=your_key BASTION_ON_CHAIN=1 cargo run --release\n```\n\n### On-chain program\n```bash\ncd programs\u002Fbastion-audit\nanchor build\nanchor deploy --provider.cluster devnet\n```\n\n## MCP HTTP Server (SSE)\n\nStart the MCP server for browser-native SSE access:\n\n```bash\nBASTION_SIDECAR_URL=https:\u002F\u002Fbastion-agentique.fly.dev\u002F \\\npnpm --filter @zkos-labs\u002Fmcp-server dev:http\n```\n\nEndpoints:\n- `GET \u002Fmcp\u002Fsse` - SSE connection\n- `POST \u002Fmcp\u002Fmessages` - MCP JSON-RPC messages (with `?sessionId=\u003Cid>`)\n- `GET \u002Fmcp\u002Fhealth` - Health check\n- `GET \u002Fmcp\u002Fpricing` - Tool pricing + free tier info\n\n**15 tools** (same as stdio MCP): simulate, ingest, get\u002Fupdate policy, audit logs\u002Fstats, override, pending, circuit breaker, cases, DID, token balances.\n\n**3 prompts:** `bastion_verify_transaction`, `bastion_security_review`, `bastion_incident_response`.\n\n## Pricing\n\nBastion is an open-source community project, released under Apache 2.0. Read operations always free. Backend API calls optionally paid via USDT\u002FUSDC:\n\n| Tool | Free\u002FMonth | Price (USD) |\n|------|-----------|-------------|\n| `bastion_simulate_transaction` | 100 | $0.10 |\n| `bastion_override_block` | 10 | $1.00 |\n| `bastion_update_policy` | 5 | $5.00 |\n| `bastion_circuit_breaker_toggle` | 3 | $10.00 |\n\n## CORS\n\n```\nAccess-Control-Allow-Origin: *\nAccess-Control-Allow-Headers: Content-Type, Authorization, X-Api-Key, X-Agent-Id\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\n```\n\n## Related Skills\n\n- **blockchain-intelligence-playbook** - Broader blockchain investigation methodology\n- **solana-onchain-intelligence-resources** - Solana-specific tools and data sources\n- **defi-security-audit-agent** - DeFi security patterns that complement Bastion policy rules\n",{"name":5,"description":7},"main","d10fe79c634de337daa2ad2fa82857c8a743616b",".agents\u002Fskills\u002Fbastion-how-to-use",1,"https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion","https:\u002F\u002Fbastionagentique.com\u002F","https:\u002F\u002Fgithub.com\u002Fzkos-labs","https:\u002F\u002Fzkoslabs.org","A research-driven builders' organization advancing programmable trust infrastructure for Ethereum and interoperable open networks.","2026-11-13 21:01:45",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add zkos-labs\u002Fbastion --skill bastion-how-to-use",{"tool":40,"command":41},"bunx","bunx skills add zkos-labs\u002Fbastion --skill bastion-how-to-use",{"tool":43,"command":44},"pnpm","pnpm dlx skills add zkos-labs\u002Fbastion --skill bastion-how-to-use","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbastion-how-to-use\u002FSKILL.md",true,[],[49,57,64,71,78,85],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":53,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7213RCWV886P2R63MTQAEGW","bastion","Programmable Trust Runtime for Autonomous Systems. Orchestrates identity, policy, privacy, durable execution, and multi-chain settlement.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7213MYSJE23KMMTD95Y3M3Z","web2-api-firewall-administrator","Guides configuring Bastion Web2 API adapter policies for the Trust Runtime. Covers endpoint allowlists, provider budgets, rate limits, content inspection (PII\u002Fsecrets detection), header filters, and OpenAPI spec-based auto-configuration. Use when configuring API call security for AI agents, setting provider spending caps, inspecting outbound API traffic, or setting up the Web2 adapter.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fweb2-api-firewall-administrator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7213HE08PE43M2H0QZENZP2","transaction-screening-workflow-concepts","Educational map of transaction-centric compliance screening-transfer as the atomic unit, deposit vs withdrawal direction, single and CSV import, transaction list and detail views, per-transfer screening, rescreen, and STR-style exports. Use when the user asks how monitoring UIs treat tx hashes, directions, or regulatory reporting hooks-not for legal filing advice or evading reporting.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ftransaction-screening-workflow-concepts\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7213DQ7TVE986643SR105Y4","solana-tracing-specialist","Guides Solana-specific on-chain forensics-ATA resolution, SPL instruction parsing, transaction history via RPC and indexers (e.g. Helius-style APIs), fund-flow graphs, Solana clustering heuristics, and program authority review. Use when the user investigates Solana wallets, SPL tokens, DEX\u002FJito flows, rug or phishing patterns on Solana, or needs evidence-structured tracing reports with public data only.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsolana-tracing-specialist\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M72138PB2HTKJ0J39WNSRCRR","solana-onchain-intelligence-resources","Companion to blockint-skills Solana work-official doc indexes and stacks for RPC\u002Findexers, sanctions and address intel MCP, web research, agent payments, graph UIs, Solana Foundation dev skills, Solana Policy Institute (policy\u002Fregulatory education), optional open-source Scrapy collection (BlockchainSpider), Impersonator Solana (dApp dev\u002Ftesting), coral-xyz sealevel-attacks (security pattern examples), Neodyme Solana Security Workshop (workshop.neodyme.io), and Osec Solana auditor introduction blog (osec.io). Use when the user needs pointers to Helius, Range AI, Tavily, PayAI x402, React Flow, Solana.com skills, or SPI alongside on-chain forensics-not as a substitute for reading current provider docs, legal counsel, or API keys.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsolana-onchain-intelligence-resources\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M72134Y4PVHN6CQPHX9NKSHQ","solana-defi-vulnerability-analyst-agent","Guides discovery and documentation of Solana DeFi protocol risks from public code and chain state-Anchor\u002Fnative programs, PDAs, CPIs, oracles, pools, SPL mechanics, and historical tx reconstruction. Use when the user asks for Solana program security review, DeFi vulnerability triage, PDA or CPI safety, oracle or liquidity-pool risk, launchpad\u002Fbonding-curve issues, or evidence-backed severity findings without exploits or private keys.","https:\u002F\u002Fgithub.com\u002Fzkos-labs\u002Fbastion\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsolana-defi-vulnerability-analyst-agent\u002FSKILL.md",[],[]]