gblin-treasury-risk-regime

Current BTC/ETH risk regime (calm | elevated | crash) with a suggested posture, read live from GBLIN's on-chain Crash Shield on Base (60s cache). Free and unsigned; a signed, verifiable-offline version is a paid x402 endpoint (resource gblin://howto/attestation).

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "regime": {
      "type": "string",
      "enum": [
        "calm",
        "elevated",
        "crash"
      ],
      "description": "Current risk regime"
    },
    "regime_code": {
      "type": "integer",
      "description": "0 calm, 1 elevated, 2 crash"
    },
    "risk_posture": {
      "type": "string",
      "enum": [
        "risk_on",
        "reduce",
        "risk_off"
      ],
      "description": "Suggested posture"
    },
    "severity_pct": {
      "type": "number",
      "description": "Max crash-shield weight cut across risk assets, percent"
    },
    "defensive_cash_pct": {
      "type": "number",
      "description": "USDC dynamic weight in the basket, percent"
    },
    "shield_active": {
      "type": "boolean",
      "description": "True when any risk asset is currently slashed"
    },
    "assets": {
      "type": "array",
      "description": "Per-risk-asset shield state",
      "items": {
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "description": "ERC-20 address"
          },
          "shielded": {
            "type": "boolean"
          },
          "base_weight_pct": {
            "type": "number"
          },
          "dynamic_weight_pct": {
            "type": "number"
          },
          "weight_cut_pct": {
            "type": "number"
          }
        },
        "required": [
          "token",
          "shielded",
          "weight_cut_pct"
        ]
      }
    },
    "contract": {
      "type": "string",
      "description": "GBLIN contract on Base"
    },
    "chain_id": {
      "type": "integer"
    },
    "source": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "regime",
    "regime_code",
    "severity_pct",
    "defensive_cash_pct",
    "shield_active",
    "assets"
  ]
}

Static, permanently expired sample of the signed Risk Attestation (sample:true), same fields and EIP-712 schema as the paid one. Use it to build and test a parser/verifier.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "sample": {
      "type": "boolean",
      "description": "Always true — never a live signal"
    },
    "attestation": {
      "type": "object",
      "description": "Same field contract as the paid attestation (regime, shield_active, severity_pct, defensive_cash_pct, expires_at, ...)"
    },
    "eip712": {
      "type": "object",
      "description": "EIP-712 domain/types/message to recompute the digest"
    },
    "attestation_id": {
      "type": "string",
      "description": "hashTypedData digest — recompute to verify"
    },
    "signature": {
      "type": [
        "string",
        "null"
      ]
    },
    "attestor": {
      "type": [
        "string",
        "null"
      ]
    },
    "signed": {
      "type": "boolean"
    },
    "verify": {
      "type": "object"
    },
    "meta": {
      "type": "object"
    }
  },
  "required": [
    "sample",
    "attestation",
    "attestation_id",
    "signed"
  ]
}

Cumulative public counters of GBLIN's x402 endpoints: paid calls, unique payer wallets, USDC earned, with methodology disclosure. Cached 5 min.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "total_paid_calls": {
      "type": "integer",
      "description": "Settled x402 calls, cumulative"
    },
    "total_unique_agents": {
      "type": "integer",
      "description": "Distinct payer wallets, cumulative (our own wallets excluded)"
    },
    "total_usdc_earned": {
      "type": "number",
      "description": "USDC received, cumulative"
    },
    "_source": {
      "type": "object",
      "description": "Provenance and disclosure of the counters",
      "properties": {
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "data_endpoint": {
          "type": "string"
        },
        "docs": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "disclosure": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "total_paid_calls",
    "total_unique_agents",
    "total_usdc_earned"
  ]
}

GBLIN llms.txt as plain text: contract addresses, endpoints, prices, payment flow, field contract of the attestation.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "llms_txt": {
      "type": "string",
      "description": "The full llms.txt document (plain text)"
    }
  },
  "required": [
    "llms_txt"
  ]
}

Append the HASHES of an AI action to GBLIN's public RFC 6962 transparency log and return a portable receipt: Ed25519 signature, inclusion proof, operator-signed C2SP checkpoint, plus the latest on-chain anchor (EAS on Base, daily). mode=demo (the only mode over MCP): 5 seals/day/IP, receipts marked demo:true. Unlimited seals are a paid x402 HTTP endpoint (resource gblin://howto/seal). Provenance is self-reported: the receipt proves existence and time of the record, not that the action happened. The action/agent_id/tool/meta strings are PUBLISHED in the log: identifiers only, never secrets. Fields not listed here are ignored and NOT recorded.

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "demo"
      ],
      "default": "demo",
      "description": "Only 'demo' is available over MCP (5/day/IP). Paid seals go through x402 HTTP."
    },
    "action": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "What the AI did, short label. PUBLISHED in the log."
    },
    "input_hash": {
      "type": "string",
      "pattern": "^\\s*(0x)?[0-9a-fA-F]{64}\\s*$",
      "description": "sha256 of the input/prompt, 64 hex chars (0x prefix optional)"
    },
    "output_hash": {
      "type": "string",
      "pattern": "^\\s*((0x)?[0-9a-fA-F]{64})?\\s*$",
      "description": "sha256 of the output, 64 hex chars (optional; empty or blank = omitted)"
    },
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "description": "Your agent identifier (optional). PUBLISHED."
    },
    "tool": {
      "type": "string",
      "maxLength": 128,
      "description": "Tool/model used (optional). PUBLISHED."
    },
    "meta": {
      "type": "string",
      "maxLength": 512,
      "description": "Extra JSON object as a string (optional). PUBLISHED."
    }
  },
  "required": [
    "action",
    "input_hash"
  ],
  "additionalProperties": true
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "const": "gblin-receipt/v1"
    },
    "payload": {
      "type": "object",
      "description": "The signed, canonicalized record (gblin-canonical-json/1)",
      "properties": {
        "v": {
          "type": "integer"
        },
        "log": {
          "type": "string"
        },
        "index": {
          "type": "integer"
        },
        "ts": {
          "type": "string"
        },
        "action": {
          "type": "string"
        },
        "agent_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "tool": {
          "type": [
            "string",
            "null"
          ]
        },
        "input_hash": {
          "type": "string"
        },
        "output_hash": {
          "type": [
            "string",
            "null"
          ]
        },
        "meta": {},
        "demo": {
          "type": "boolean"
        },
        "by": {
          "type": "string",
          "enum": [
            "operator"
          ],
          "description": "Present only when this server sealed its own action; set server-side, cannot be supplied by a caller"
        }
      },
      "required": [
        "v",
        "log",
        "index",
        "ts",
        "action",
        "input_hash"
      ]
    },
    "canonicalization": {
      "type": "object",
      "description": "The serialisation rule these bytes were produced with, named in the receipt itself so a later verifier can recompute them without consulting our repository. Frozen as gblin-canonical-json/1.",
      "properties": {
        "rule": {
          "type": "string",
          "const": "gblin-canonical-json/1"
        },
        "frozen_since": {
          "type": "string"
        },
        "spec": {
          "type": "string"
        },
        "leaf": {
          "type": "string"
        },
        "node": {
          "type": "string"
        },
        "signed_message": {
          "type": "string"
        },
        "verifier": {
          "type": "string"
        }
      },
      "required": [
        "rule",
        "spec"
      ]
    },
    "leaf": {
      "type": "string",
      "description": "base64 SHA256(0x00 || canonical)"
    },
    "index": {
      "type": "integer"
    },
    "tree_size": {
      "type": "integer"
    },
    "root": {
      "type": "string",
      "description": "base64 Merkle root at tree_size"
    },
    "signature": {
      "type": "string",
      "description": "base64 Ed25519 over 'gblin-receipt/v1\\n' + canonical"
    },
    "verifier_key": {
      "type": "string",
      "description": "C2SP note verifier key: origin+hash+base64(0x01||pub)"
    },
    "inclusion_proof": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "checkpoint": {
      "type": "string",
      "description": "C2SP signed note (origin, size, root)"
    },
    "anchor": {
      "type": "object",
      "description": "Latest daily EAS anchor of the tree root on Base and whether it already covers this receipt",
      "properties": {
        "chain": {
          "type": "string"
        },
        "method": {
          "type": "string"
        },
        "eas_schema_uid": {
          "type": "string"
        },
        "promise_id": {
          "type": "string"
        },
        "last_anchor": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "day": {
              "type": "string"
            },
            "tree_size": {
              "type": "integer"
            },
            "root": {
              "type": "string"
            },
            "tx": {
              "type": "string"
            }
          }
        },
        "root_covers_this_receipt": {
          "type": "boolean",
          "description": "true iff index < anchored_tree_size: the anchored ROOT commits to this leaf via the inclusion proof"
        },
        "covers_this_receipt": {
          "type": "boolean",
          "description": "deprecated alias of root_covers_this_receipt"
        },
        "anchored_tree_size": {
          "type": [
            "integer",
            "null"
          ]
        },
        "what_is_anchored": {
          "type": "string"
        },
        "explorer": {
          "type": "string"
        }
      },
      "required": [
        "root_covers_this_receipt",
        "anchored_tree_size",
        "what_is_anchored"
      ]
    },
    "provenance": {
      "type": "object",
      "description": "What the receipt does and does not prove",
      "properties": {
        "level": {
          "type": "string",
          "enum": [
            "self-reported",
            "server-observed",
            "externally-verified"
          ]
        },
        "levels": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "levels_meaning": {
          "type": "object"
        },
        "meaning": {
          "type": "string"
        }
      },
      "required": [
        "level",
        "levels"
      ]
    }
  },
  "required": [
    "format",
    "payload",
    "leaf",
    "index",
    "tree_size",
    "root",
    "signature",
    "verifier_key",
    "inclusion_proof",
    "checkpoint",
    "anchor",
    "provenance"
  ]
}

Receipt #index from GBLIN's receipts log, re-signed (Ed25519 is deterministic) with a fresh inclusion proof, the current signed checkpoint and the latest on-chain anchor. Free.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "minimum": 0,
      "description": "Receipt index in the log (0-based; current size at GET /log/checkpoint)"
    }
  },
  "required": [
    "index"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "const": "gblin-receipt/v1"
    },
    "payload": {
      "type": "object",
      "description": "The signed, canonicalized record (gblin-canonical-json/1)",
      "properties": {
        "v": {
          "type": "integer"
        },
        "log": {
          "type": "string"
        },
        "index": {
          "type": "integer"
        },
        "ts": {
          "type": "string"
        },
        "action": {
          "type": "string"
        },
        "agent_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "tool": {
          "type": [
            "string",
            "null"
          ]
        },
        "input_hash": {
          "type": "string"
        },
        "output_hash": {
          "type": [
            "string",
            "null"
          ]
        },
        "meta": {},
        "demo": {
          "type": "boolean"
        },
        "by": {
          "type": "string",
          "enum": [
            "operator"
          ],
          "description": "Present only when this server sealed its own action; set server-side, cannot be supplied by a caller"
        }
      },
      "required": [
        "v",
        "log",
        "index",
        "ts",
        "action",
        "input_hash"
      ]
    },
    "canonicalization": {
      "type": "object",
      "description": "The serialisation rule these bytes were produced with, named in the receipt itself so a later verifier can recompute them without consulting our repository. Frozen as gblin-canonical-json/1.",
      "properties": {
        "rule": {
          "type": "string",
          "const": "gblin-canonical-json/1"
        },
        "frozen_since": {
          "type": "string"
        },
        "spec": {
          "type": "string"
        },
        "leaf": {
          "type": "string"
        },
        "node": {
          "type": "string"
        },
        "signed_message": {
          "type": "string"
        },
        "verifier": {
          "type": "string"
        }
      },
      "required": [
        "rule",
        "spec"
      ]
    },
    "leaf": {
      "type": "string",
      "description": "base64 SHA256(0x00 || canonical)"
    },
    "index": {
      "type": "integer"
    },
    "tree_size": {
      "type": "integer"
    },
    "root": {
      "type": "string",
      "description": "base64 Merkle root at tree_size"
    },
    "signature": {
      "type": "string",
      "description": "base64 Ed25519 over 'gblin-receipt/v1\\n' + canonical"
    },
    "verifier_key": {
      "type": "string",
      "description": "C2SP note verifier key: origin+hash+base64(0x01||pub)"
    },
    "inclusion_proof": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "checkpoint": {
      "type": "string",
      "description": "C2SP signed note (origin, size, root)"
    },
    "anchor": {
      "type": "object",
      "description": "Latest daily EAS anchor of the tree root on Base and whether it already covers this receipt",
      "properties": {
        "chain": {
          "type": "string"
        },
        "method": {
          "type": "string"
        },
        "eas_schema_uid": {
          "type": "string"
        },
        "promise_id": {
          "type": "string"
        },
        "last_anchor": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "day": {
              "type": "string"
            },
            "tree_size": {
              "type": "integer"
            },
            "root": {
              "type": "string"
            },
            "tx": {
              "type": "string"
            }
          }
        },
        "root_covers_this_receipt": {
          "type": "boolean",
          "description": "true iff index < anchored_tree_size: the anchored ROOT commits to this leaf via the inclusion proof"
        },
        "covers_this_receipt": {
          "type": "boolean",
          "description": "deprecated alias of root_covers_this_receipt"
        },
        "anchored_tree_size": {
          "type": [
            "integer",
            "null"
          ]
        },
        "what_is_anchored": {
          "type": "string"
        },
        "explorer": {
          "type": "string"
        }
      },
      "required": [
        "root_covers_this_receipt",
        "anchored_tree_size",
        "what_is_anchored"
      ]
    },
    "provenance": {
      "type": "object",
      "description": "What the receipt does and does not prove",
      "properties": {
        "level": {
          "type": "string",
          "enum": [
            "self-reported",
            "server-observed",
            "externally-verified"
          ]
        },
        "levels": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "levels_meaning": {
          "type": "object"
        },
        "meaning": {
          "type": "string"
        }
      },
      "required": [
        "level",
        "levels"
      ]
    }
  },
  "required": [
    "format",
    "payload",
    "leaf",
    "index",
    "tree_size",
    "root",
    "signature",
    "verifier_key",
    "inclusion_proof",
    "checkpoint",
    "anchor",
    "provenance"
  ]
}

Verify a gblin-receipt/v1 JSON with pure math (no log lookup, no trust in this server): leaf hash, Ed25519 signature, RFC 6962 inclusion proof, C2SP checkpoint signature, verifier-key hash. Same checks as the zero-dependency verify-receipt.mjs you can run offline. For the extra on-chain-anchor consistency check use GET /v1/verify/:index.

{
  "type": "object",
  "properties": {
    "receipt": {
      "type": "object",
      "description": "The receipt JSON as returned by receipts.seal / receipts.get / GET /v1/receipt/:i (bare or wrapped in {receipt})"
    }
  },
  "required": [
    "receipt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "format": {
      "type": "string"
    },
    "index": {
      "type": "integer"
    },
    "tree_size": {
      "type": "integer"
    },
    "checks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "ok": {
            "type": "boolean"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "ok"
        ]
      }
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "reminder": {
      "type": "string"
    }
  },
  "required": [
    "valid",
    "checks",
    "errors"
  ]
}

Kept/violated tallies for GBLIN's pre-registered, hash-pinned promises (attestation uptime, counter honesty), probed every 10 minutes; each closed UTC day is sealed on Base as an EAS attestation (schema 0x9f433a96…). Self-observation only in v0. Free.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "subject": {
      "type": "string",
      "description": "Observed subject"
    },
    "promises": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Short promise id (P1, P2, ...)"
          },
          "promiseId": {
            "type": "string",
            "description": "keccak256 of the pre-registered promise file"
          },
          "file": {
            "type": "string",
            "description": "Public URL of the promise file"
          },
          "observations": {
            "type": "integer"
          },
          "kept": {
            "type": "integer"
          },
          "violations": {
            "type": "integer"
          },
          "kept_bps": {
            "type": "integer",
            "description": "Kept ratio in basis points (10000 = 100%)"
          },
          "last_observation": {
            "type": "string"
          },
          "last_status": {
            "type": "string",
            "enum": [
              "kept",
              "violated"
            ]
          }
        }
      }
    },
    "observing_since": {
      "type": "string"
    },
    "method": {
      "type": "string"
    }
  },
  "required": [
    "subject",
    "promises"
  ]
}

Read the current GBLIN protocol state on Base mainnet: NAV in USD, basket composition with dynamic weights, and Crash Shield status. Use this BEFORE any swap to know the current price and risk regime.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "nav_usd": {
      "type": "number",
      "description": "Net asset value of one GBLIN share in USD."
    },
    "eth_price_usd": {
      "type": "number",
      "description": "ETH price in USD from the oracle."
    },
    "nav_reliable": {
      "type": "boolean",
      "description": "False when a price feed is stale or a basket asset cannot be read; do not trade on the NAV then."
    },
    "management_fee_bps_per_year": {
      "type": "number",
      "description": "Management fee in basis points per year, read from the contract."
    },
    "auction_open": {
      "type": "boolean",
      "description": "True while a rebalancing auction is running."
    },
    "crash_shield_active": {
      "type": "boolean",
      "description": "True when the crash shield has cut the weight of a falling asset."
    },
    "slippage_buffer_pct": {
      "type": "number"
    },
    "slippage_reason": {
      "type": "string"
    },
    "basket": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Assets in the basket with base and dynamic weights."
    },
    "meta": {
      "type": "object"
    }
  },
  "required": [
    "nav_usd",
    "eth_price_usd",
    "nav_reliable",
    "management_fee_bps_per_year",
    "auction_open",
    "crash_shield_active",
    "basket"
  ],
  "additionalProperties": true
}

Preview a buy (ETH→GBLIN) or sell (GBLIN→ETH) without executing. Returns expected output, safe minOut with dynamic slippage buffer (2.5% normal / 4% during Crash Shield), and fee breakdown. Read-only.

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "amount_in": {
      "type": "string",
      "description": "Positive decimal. ETH for buy, GBLIN for sell."
    }
  },
  "required": [
    "direction",
    "amount_in"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "amount_in_eth": {
      "type": "string",
      "description": "Buy only."
    },
    "expected_gblin_out": {
      "type": "string",
      "description": "Buy only."
    },
    "safe_min_gblin_out": {
      "type": "string",
      "description": "Buy only. Pass as minOut."
    },
    "amount_in_gblin": {
      "type": "string",
      "description": "Sell only."
    },
    "expected_eth_out": {
      "type": "string",
      "description": "Sell only."
    },
    "safe_min_eth_out": {
      "type": "string",
      "description": "Sell only. Pass as minEthOut."
    },
    "fees": {
      "type": "object"
    },
    "slippage_buffer_bps": {
      "type": "number"
    },
    "slippage_reason": {
      "type": "string"
    },
    "will_revert_with_zero_tolerance": {
      "type": "boolean"
    },
    "cooldown_note": {
      "type": "string"
    },
    "next_step": {
      "type": "string"
    }
  },
  "required": [
    "direction",
    "slippage_buffer_bps",
    "next_step"
  ],
  "additionalProperties": true
}

Analyze an agent wallet's treasury health: GBLIN/USDC/ETH balances, whether the ETH covers an exit at the live gas price, the redemption cooldown, and (if daily_burn_usd is provided) days of USDC runway plus a recommendation that keeps seven days of spend in USDC and treats only the surplus as a candidate for GBLIN. Free by default; metered at $0.003 USDC only when the operator sets MCP_PAYWALL=true.

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Agent's 0x address."
    },
    "daily_burn_usd": {
      "type": "number",
      "description": "Optional. Average daily spend in USD (e.g. 1.5)."
    },
    "_payment": {
      "type": "string",
      "description": "Base64-encoded x402 PaymentProof JSON. Omit on first call to receive the 402 payment manifest."
    }
  },
  "required": [
    "wallet_address"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "balances": {
      "type": "object"
    },
    "ratios": {
      "type": "object"
    },
    "gas_health": {
      "type": "object",
      "description": "Whether the wallet holds enough ETH for the next transactions."
    },
    "cooldown": {
      "type": "object",
      "description": "Whether the redemption cooldown is active and for how long."
    },
    "recommendation": {
      "type": "object",
      "description": "hold, rebalance_to_gblin or rebalance_to_usdc, with the reason."
    }
  },
  "required": [
    "wallet",
    "balances",
    "gas_health",
    "cooldown",
    "recommendation"
  ],
  "additionalProperties": true
}

Idle USDC to a reviewable plan in one call: operating cash = max(reserve_usd, daily_burn_usd × days), the surplus above it, a simulation of minting that surplus into GBLIN at NAV (fees read live from the vault, estimated exit value today, round-trip cost), the same simulation for a trial amount (100 USDC by default), the blockers (crash shield, redemption cooldown, ETH for the exit) and the tools to call after a human confirms. Reads only: nothing is executed and nothing is advised. GBLIN is crypto exposure (cbBTC, WETH, USDC), not cash and not yield.

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Agent's 0x address."
    },
    "daily_burn_usd": {
      "type": "number",
      "description": "Average daily spend in USD. Operating cash = daily_burn_usd × days."
    },
    "days": {
      "type": "number",
      "description": "Days of spend to keep liquid (default 7, max 365)."
    },
    "reserve_usd": {
      "type": "number",
      "description": "USD to keep liquid regardless of the burn rate; the larger of the two rules wins."
    },
    "trial_usdc": {
      "type": "number",
      "description": "Trial amount to simulate beside the surplus (default 100)."
    }
  },
  "required": [
    "wallet_address"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "as_of": {
      "type": "object",
      "description": "Block and time the reads were taken at."
    },
    "inputs": {
      "type": "object",
      "description": "The inputs as applied, with the defaults filled in."
    },
    "market": {
      "type": "object",
      "description": "NAV, ETH price, risk regime and crash shield status."
    },
    "wallet_state": {
      "type": "object",
      "description": "USDC, GBLIN and ETH balances, gas health, redemption cooldown."
    },
    "operating_cash": {
      "type": "object",
      "description": "USDC to keep liquid: max(reserve_usd, daily_burn_usd × days), with the runway in days."
    },
    "surplus": {
      "type": "object",
      "description": "USDC above the operating cash."
    },
    "park_candidate": {
      "type": "boolean",
      "description": "True when no blocker applies. Not a recommendation."
    },
    "blockers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Reasons parking is not appropriate right now, if any."
    },
    "simulation": {
      "type": "object",
      "description": "Mint simulation for the surplus: shares, fees, exit value today, round-trip cost; or nothing_to_park."
    },
    "trial": {
      "type": "object",
      "description": "The same simulation for the trial amount."
    },
    "next": {
      "type": "object",
      "description": "The tools to call after a human confirms."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "wallet",
    "market",
    "wallet_state",
    "operating_cash",
    "surplus",
    "park_candidate",
    "blockers",
    "simulation",
    "trial",
    "next"
  ],
  "additionalProperties": true
}

NAV per GBLIN share over time, read from the chain at past blocks, beside the ETH/USD and BTC/USD oracle prices the vault itself uses, with the change of each over the window and the NAV's largest drawdown. History starts at the deployment of the vault in service. Use it to judge how the index behaved against holding ETH or BTC over the same span.

{
  "type": "object",
  "properties": {
    "interval": {
      "type": "string",
      "enum": [
        "hour",
        "day"
      ],
      "description": "Spacing of the points. Default day."
    },
    "points": {
      "type": "integer",
      "minimum": 2,
      "maximum": 90,
      "description": "How many points, newest last. Default 30."
    }
  },
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "interval": {
      "type": "string",
      "enum": [
        "hour",
        "day"
      ]
    },
    "points": {
      "type": "number"
    },
    "series": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Oldest first: time, block, NAV in ETH and USD, ETH/USD and BTC/USD."
    },
    "summary": {
      "type": [
        "object",
        "null"
      ],
      "description": "Change of NAV, ETH and BTC over the window, and the NAV's largest drawdown."
    },
    "note": {
      "type": "string"
    },
    "method": {
      "type": "string"
    }
  },
  "required": [
    "interval",
    "points",
    "series"
  ],
  "additionalProperties": true
}

Build the unsigned transactions for any operation on the GBLIN vault, in the order to send them. Actions: mint_with_eth (amount in ETH), mint_with_weth (amount in WETH), mint_with_usdc (amount in USDC, through the Zap), redeem_in_kind (amount in shares; pro rata basket tokens, no fee, no price feed), exit_to_eth (amount in shares, through the Zap, all or nothing), exit_to_usdc (amount = the USDC you need), bid (trade with the rebalancing auction; row optional, the largest gap by default). Every output bound is non-zero and every step through the vault or the Zap carries its gas limit. Nothing is signed or sent: simulate the steps with preview_steps, then send them from the wallet.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "mint_with_eth",
        "mint_with_weth",
        "mint_with_usdc",
        "redeem_in_kind",
        "exit_to_eth",
        "exit_to_usdc",
        "bid"
      ],
      "description": "The operation to prepare."
    },
    "wallet_address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "The wallet that will sign and receive."
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)?$",
      "description": "Decimal amount. Unit depends on the action (see the description). Not used by bid."
    },
    "row": {
      "type": "integer",
      "minimum": 0,
      "description": "bid only: the basket row to bid on. Default: the row with the largest gap."
    }
  },
  "required": [
    "action",
    "wallet_address"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string"
    },
    "wallet": {
      "type": "string"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One transaction to send, in order: target, calldata, value in wei, and gas when the step needs an explicit limit. The same call is repeated as to, data and chainId (8453) for wallet batch APIs such as send_calls."
      },
      "description": "Transactions to send in order."
    },
    "expected": {
      "type": "object",
      "description": "What the operation should deliver, with the minimums applied."
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next": {
      "type": "string"
    }
  },
  "required": [
    "action",
    "steps"
  ],
  "additionalProperties": true
}

Simulate a list of transactions in sequence against the latest Base block, as if the wallet sent them one after the other, before anything is signed. Each step sees the state the previous ones left (an approval before a mint works). Returns, per step, whether it would succeed, the gas it uses, whether the gas limit it carries is enough, and the decoded revert reason with a hint when it fails; and the net token and ETH movements for the wallet. Pass the steps exactly as prepare_action, invest_usdc_to_gblin or swap_gblin_to_usdc_jit return them. State can change before your transactions land: a successful preview is evidence, not a guarantee.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "The wallet that will send the steps."
    },
    "steps": {
      "type": "array",
      "minItems": 1,
      "maxItems": 8,
      "description": "The steps, in order: target and calldata (or their send_calls spellings, to and data), value in wei (optional), gas (optional).",
      "items": {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$",
            "description": "Contract to call. Alias: to."
          },
          "calldata": {
            "type": "string",
            "pattern": "^0x([0-9a-fA-F]{2})*$",
            "description": "ABI-encoded call. Alias: data."
          },
          "to": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          },
          "data": {
            "type": "string",
            "pattern": "^0x([0-9a-fA-F]{2})*$"
          },
          "value": {
            "type": "string",
            "pattern": "^\\d+$"
          },
          "gas": {
            "type": "string",
            "pattern": "^\\d+$"
          }
        },
        "required": [],
        "additionalProperties": true
      }
    }
  },
  "required": [
    "from",
    "steps"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "would_succeed": {
      "type": "boolean",
      "description": "True only if every step succeeds in the simulation."
    },
    "from": {
      "type": "string"
    },
    "block": {
      "type": "number",
      "description": "The block the simulation ran on."
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Per step: success, gas used, whether the given limit is enough, recommended limit, revert reason."
    },
    "first_failing_step": {
      "type": [
        "number",
        "null"
      ]
    },
    "balance_changes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Net token and ETH movements for the wallet."
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "would_succeed",
    "steps",
    "balance_changes"
  ],
  "additionalProperties": true
}

Report what a sent Base transaction did: pending, succeeded, reverted or not found; its block and confirmations; the fee paid; the net token movements for the sender (GBLIN shares minted or redeemed, USDC, basket tokens); and, when it reverted, the decoded reason. Use it after sending the steps from prepare_action to confirm each one before the next.

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "The transaction hash."
    }
  },
  "required": [
    "hash"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "not_found",
        "success",
        "reverted"
      ]
    },
    "block": {
      "type": "number"
    },
    "confirmations": {
      "type": [
        "number",
        "null"
      ]
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": [
        "string",
        "null"
      ]
    },
    "gas_used": {
      "type": "number"
    },
    "gas_limit": {
      "type": [
        "number",
        "null"
      ]
    },
    "fee_eth": {
      "type": "string"
    },
    "balance_changes": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "revert": {
      "type": "object"
    },
    "explorer": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "hash",
    "status"
  ],
  "additionalProperties": true
}

Verify GBLIN protocol governance state: confirms whether the GBLIN vault is owned by the 48h Timelock, reads the timelock's min delay and grace period, reports role member counts, and surfaces any pending asset-addition proposal on the index contract. If an operation_id is provided, also reports the status of that specific timelock operation. Read-only — use this to gate trust-sensitive agent actions.

{
  "type": "object",
  "properties": {
    "operation_id": {
      "type": "string",
      "description": "Optional 0x-prefixed 32-byte hex id of a specific timelock operation to inspect."
    }
  },
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string"
    },
    "lens": {
      "type": "string"
    },
    "owner": {
      "type": "string"
    },
    "owner_is_timelock": {
      "type": "boolean"
    },
    "owner_is_renounced": {
      "type": "boolean"
    },
    "fee_recipient": {
      "type": "string"
    },
    "trust_summary": {
      "type": "string"
    },
    "timelock": {
      "type": "object",
      "description": "Address and minimum delay of the timelock, read on chain."
    },
    "pending_handover": {
      "type": [
        "object",
        "null"
      ],
      "description": "A pending ownership transfer, or null."
    },
    "pending_timelock_operation": {
      "type": [
        "object",
        "null"
      ],
      "description": "A scheduled timelock operation affecting ownership, or null."
    },
    "verification": {
      "type": "object"
    }
  },
  "required": [
    "vault",
    "owner",
    "owner_is_timelock",
    "owner_is_renounced",
    "timelock"
  ],
  "additionalProperties": true
}

Read the GBLIN rebalancing auction on Base. The vault does not rebalance itself and pays nobody to do it: when a basket row drifts past its band it holds a Dutch auction, and whoever trades with it toward the target weights is the counterparty, at the oracle price adjusted by a premium that starts at a discount and rises to a cap over one ramp. Returns, per row, the side the vault takes, the gap in ETH, the token and amount the bidder hands over, and unsigned calldata (approval + bid). The premium is the whole reward; nothing is paid out of the vault.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string"
    },
    "lens": {
      "type": "string"
    },
    "navReliable": {
      "type": "boolean"
    },
    "auctionOpen": {
      "type": "boolean"
    },
    "premiumBps": {
      "type": "number",
      "description": "Current premium over the oracle price, in basis points; negative is a discount."
    },
    "curve": {
      "type": "object"
    },
    "openedAt": {
      "type": [
        "number",
        "string",
        "null"
      ],
      "description": "When the auction opened, or null when closed."
    },
    "worstGapEth": {
      "type": "string"
    },
    "totalValueEth": {
      "type": "string"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "One entry per basket asset: side, gap from target and amount a bidder can fill."
    },
    "best": {
      "type": [
        "object",
        "null"
      ],
      "description": "The row with the largest gap, or null."
    },
    "howToBid": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "vault",
    "navReliable",
    "auctionOpen",
    "premiumBps",
    "rows"
  ],
  "additionalProperties": true
}

Build a gasless GBLIN payment. The vault's share token implements EIP-3009, so the holder signs an authorization and anybody can carry it on chain: the payer needs no ETH. Returns the EIP-712 message to sign (its domain is read from the token, not assumed), the calldata that carries the signed authorization, and the x402 'exact' payload for paying an HTTP endpoint in GBLIN. Use method 'receive' when paying a known recipient: only that recipient can submit it, so nobody can front-run the transfer. Use 'transfer' for an x402 facilitator, which submits on the seller's behalf. With relay: true it also prepares the fee authorization for relay_gblin_payment, for when nobody else will carry the payment. No private key is requested, held or transmitted: the signature is produced by the caller's own wallet.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "The payer's address: the wallet that will sign."
    },
    "to": {
      "type": "string",
      "description": "The recipient's address."
    },
    "amount_gblin": {
      "type": "string",
      "description": "Amount in GBLIN shares, e.g. '0.25'. Give this or amount_usd."
    },
    "amount_usd": {
      "type": "string",
      "description": "Amount in USD, converted at the live NAV. Give this or amount_gblin."
    },
    "method": {
      "type": "string",
      "enum": [
        "receive",
        "transfer"
      ],
      "description": "'receive' (default) can be submitted only by the recipient; 'transfer' by anyone."
    },
    "valid_for_seconds": {
      "type": "number",
      "description": "How long the authorization stays valid. Default 600, maximum 86400."
    },
    "relay": {
      "type": "boolean",
      "description": "true when nobody else will carry the payment on chain: also prepares the relay fee authorization, paid in GBLIN at the live NAV, for relay_gblin_payment. Forces method 'transfer'."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "authorization": {
      "type": "object",
      "description": "from, to, value, validAfter, validBefore, nonce."
    },
    "method": {
      "type": "string",
      "enum": [
        "receive",
        "transfer"
      ]
    },
    "typed_data": {
      "type": "object",
      "description": "The EIP-712 message to sign with eth_signTypedData_v4."
    },
    "digest": {
      "type": "string",
      "description": "The EIP-712 digest of typed_data."
    },
    "amount": {
      "type": "object"
    },
    "payer_balance": {
      "type": "object"
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "submit": {
      "type": "object"
    },
    "x402_payload": {
      "type": "object",
      "description": "The x402 exact-scheme payment payload, with the signature left to fill."
    },
    "x402_accepts_for_sellers": {
      "type": "object"
    },
    "relay": {
      "type": "object",
      "description": "With relay: true, the fee authorization to sign and where to send both."
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "authorization",
    "method",
    "typed_data",
    "digest",
    "x402_payload"
  ],
  "additionalProperties": true
}

Check a signed GBLIN authorization against the chain before spending gas on it. Recovers the signer from the EIP-712 digest (and asks the wallet itself through ERC-1271 when the payer is a contract), then checks the validity window against on-chain time, whether the nonce has already been used or cancelled, and whether the payer still holds the amount. Returns a verdict and the ready calldata when it would settle, the failing reason when it would not. This is the same set of checks an x402 facilitator runs, so a 'would_settle' verdict here means the payment is good to carry.

{
  "type": "object",
  "properties": {
    "authorization": {
      "type": "object",
      "description": "The authorization object: from, to, value, validAfter, validBefore, nonce.",
      "additionalProperties": true
    },
    "signature": {
      "type": "string",
      "description": "The signature produced by the payer's wallet, 0x-prefixed."
    },
    "method": {
      "type": "string",
      "enum": [
        "receive",
        "transfer"
      ],
      "description": "Which method the signature was produced for. Default 'receive'."
    }
  },
  "required": [
    "authorization",
    "signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "would_settle": {
      "type": "boolean",
      "description": "True only if the token would accept this authorization now."
    },
    "method": {
      "type": "string",
      "enum": [
        "receive",
        "transfer"
      ]
    },
    "digest": {
      "type": "string"
    },
    "checks": {
      "type": "object"
    },
    "failures": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Reasons it would not settle; empty when it would."
    },
    "amount": {
      "type": "object"
    },
    "submit": {
      "type": [
        "object",
        "null"
      ],
      "description": "Calldata and who may submit it, or null when it would not settle."
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "would_settle",
    "method",
    "checks",
    "failures"
  ],
  "additionalProperties": true
}

Have GBLIN's relay carry a signed GBLIN payment on chain for a payer that holds no ETH. Pass the payment and the relay fee, each as { authorization, signature }, both prepared by prepare_gblin_payment with relay: true and signed by the payer's wallet. The relay checks both against the chain, simulates them and submits them in one transaction through Multicall3: either both settle or neither does. The fee is paid in GBLIN at the live NAV. Returns the transaction hash and its outcome. This moves funds: run it only with authorizations the payer meant to sign.

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "object",
      "description": "{ authorization, signature } of the payment, method 'transfer'.",
      "properties": {
        "authorization": {
          "type": "object"
        },
        "signature": {
          "type": "string",
          "pattern": "^0x[0-9a-fA-F]+$"
        }
      },
      "required": [
        "authorization",
        "signature"
      ]
    },
    "fee": {
      "type": "object",
      "description": "{ authorization, signature } of the relay fee, from prepare_gblin_payment's relay block.",
      "properties": {
        "authorization": {
          "type": "object"
        },
        "signature": {
          "type": "string",
          "pattern": "^0x[0-9a-fA-F]+$"
        }
      },
      "required": [
        "authorization",
        "signature"
      ]
    }
  },
  "required": [
    "payment",
    "fee"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "relay": {
      "type": "string",
      "description": "The relay that carried the payment."
    },
    "status": {
      "type": "string",
      "enum": [
        "settled",
        "reverted",
        "submitted"
      ]
    },
    "transaction": {
      "type": "string",
      "description": "The transaction hash."
    },
    "explorer": {
      "type": "string"
    },
    "payment": {
      "type": "object"
    },
    "fee": {
      "type": "object"
    },
    "block": {
      "type": "number"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "relay",
    "status",
    "transaction"
  ],
  "additionalProperties": true
}

Verify a GBLIN Risk Attestation — the object returned by GBLIN's /api/x402/attestation, or a proof-of-diligence a peer agent attached to its action. FREE, no payment. Runs four checks: (1) INTEGRITY — recomputes the EIP-712 attestation_id and detects tampering; (2) AUTHENTICITY — if a signature is present, recovers the signer and checks it is GBLIN's published attestor; (3) FRESHNESS — whether it expired (10-minute TTL), using on-chain time; (4) LIVE DRIFT — compares the attested regime to the CURRENT on-chain regime and flags if it changed. Use before you trust any counterparty/peer that claims it 'checked market risk via GBLIN'.

{
  "type": "object",
  "properties": {
    "attestation": {
      "type": "object",
      "description": "The full attestation object from /api/x402/attestation (must include `eip712`; `attestation_id`, `signature`, `attestor` are used when present). A JSON string of that object is also accepted."
    },
    "expected_attestor": {
      "type": "string",
      "description": "Optional 0x address to check the signature against. Defaults to the GBLIN attestor address baked into this MCP build (GBLIN_ATTESTOR_ADDRESS env).",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    }
  },
  "required": [
    "attestation"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean",
      "description": "True only if every check passed."
    },
    "checks": {
      "type": "object",
      "description": "Each check by name, with its result."
    },
    "attested": {
      "type": "object"
    },
    "live": {
      "type": "object"
    },
    "recomputed_attestation_id": {
      "type": "string"
    },
    "guidance": {
      "type": "string"
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "valid",
    "checks"
  ],
  "additionalProperties": true
}

Search GBLIN's documentation and live state and return matching documents: the agent API summary, the protocol's README and documents (governance, deployments, review record), the MCP server and library READMEs, the public pages, one card per MCP tool, and a snapshot of the live vault state. Returns {results: [{id, title, url}]}; pass an id to fetch for the full text. Read-only and free.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for, in plain words."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ]
      }
    }
  },
  "required": [
    "results"
  ]
}

Return the full text of one document found with search: {id, title, text, url, metadata}. Documents are the protocol's public documentation, the tool cards and the live vault state. Read-only and free.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A document id returned by search."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ]
}