plugin-gblin

ElizaOS plugin — gasless treasury management for AI agents on Base mainnet.

Park idle USDC into the GBLIN MEV-protected index (cbBTC / WETH / USDC), JIT-swap back to USDC to pay x402 invoices, and monitor treasury health — all from inside your ElizaOS agent.

What it does

| Action | Trigger phrases | Cost | |---|---|---| | CHECK_GBLIN_TREASURY_HEALTH | "check my treasury", "wallet status" | $0.002 USDC | | INVEST_IDLE_USDC_GBLIN | "park USDC in GBLIN", "buy GBLIN", "invest 10 USDC" | $0.002 USDC | | RESCUE_USDC_FROM_GBLIN | "need USDC", "sell GBLIN", "JIT swap", "pay invoice" | $0.005 USDC |

The Provider (GBLIN_TREASURY_CONTEXT) injects live NAV, basket weights, and Crash Shield status into every agent loop ($0.001 USDC per call).

All payments are gasless for the agent: the Coinbase CDP facilitator pays on-chain gas; the agent only signs an EIP-3009 transferWithAuthorization.

Install

# with npm
npm install plugin-gblin

# with bun (elizaos default)
bun add plugin-gblin

Or via the ElizaOS CLI:

elizaos plugins add gblin

Configuration

Add to your agent's .env:

# Required
EVM_PRIVATE_KEY=0x_your_agent_hot_wallet_private_key

# Optional — override defaults
GBLIN_BASE_URL=https://gblin.digital
GBLIN_RPC_URL=https://base-rpc.publicnode.com

Security: use a dedicated hot wallet for the agent with only the USDC/GBLIN it needs. Never use a founder or treasury wallet here. The maximum a malicious endpoint could drain in one run is $0.005 USDC.

Add to your character

// character.ts
import { type Character } from "@elizaos/core";

export const character: Character = {
  name: "TreasuryAgent",
  plugins: [
    "@elizaos/plugin-sql",
    "@elizaos/plugin-bootstrap",
    // Add GBLIN only if private key is set
    ...(process.env.EVM_PRIVATE_KEY?.trim() ? ["plugin-gblin"] : []),
  ],
  // ...
};

Or in character.json:

{
  "name": "TreasuryAgent",
  "plugins": ["plugin-gblin"],
  "settings": {
    "secrets": {
      "EVM_PRIVATE_KEY": "0x..."
    }
  }
}

How it works

Agent LLM decides "I have idle USDC"
  ↓
triggers INVEST_IDLE_USDC_GBLIN action
  ↓
plugin sends GET /api/x402/invest?usdc=10 (preflight → 402)
  ↓
plugin signs EIP-3009 transferWithAuthorization ($0.002 USDC)
  ↓
plugin retries with PAYMENT-SIGNATURE header
  ↓
GBLIN API returns {steps: [{target, calldata}, {target, calldata}]}
  ↓
plugin broadcasts step 1 (USDC approve) → waits confirmation
  ↓
plugin broadcasts step 2 (buyGBLINWithToken) → waits confirmation
  ↓
callback: "✅ Invested $10 USDC → GBLIN. tx: 0xab12..."

Endpoints consumed

All calls go to https://gblin.digital/api/x402/*. Each is a paid x402 v2 endpoint on Base mainnet (chain id 8453, USDC 0x8335...).

| Path | Price | Returns | |---|---|---| | GET /api/x402/treasury-state | $0.001 | NAV, basket, Crash Shield | | GET /api/x402/health?wallet= | $0.002 | balances, gas runway, recommendation | | GET /api/x402/invest?usdc= | $0.002 | sequential tx calldata | | GET /api/x402/jit?usdc=&wallet= | $0.005 | atomic swap calldata |

Discovery manifest: gblin.digital/api/x402/llms.txt

Protocol

• Contract: 0x38DcDB3A381677239BBc652aed9811F2f8496345 (Base mainnet)
• Owner: 48h Timelock — every parameter change takes 48 hours on-chain
• Basket: 45% cbBTC + 45% WETH + 10% USDC (rebalances with on-chain Crash Shield)
• MCP Server: @gblin-protocol/mcp-server — free alternative for Claude Desktop / Cursor

License

MIT © GBLIN Protocol