@gblin-protocol/mcp-server 0.4.3 → 0.5.1

package/dist/output-schemas.js

@@ -0,0 +1,243 @@
+/**
+ * GBLIN MCP — output schemas.
+ *
+ * Every tool that returns a JSON object declares its shape here, so a client can validate the
+ * `structuredContent` of a successful result and generate types from it. Error results carry
+ * `isError: true` and no structured content, so they are outside these schemas.
+ *
+ * The `required` list of each schema is the contract: fields a successful call always returns.
+ * Other fields are described but optional, and `additionalProperties` stays open, so adding a
+ * field later is not a breaking change. Removing or retyping a required field is.
+ *
+ * seal_action_demo has no schema: its result is the hosted log's receipt, whose shape is published
+ * by the log itself (see get_receipt for the fields a reader can rely on).
+ */
+const str = (description) => ({ type: "string", ...(description ? { description } : {}) });
+const num = (description) => ({ type: "number", ...(description ? { description } : {}) });
+const bool = (description) => ({ type: "boolean", ...(description ? { description } : {}) });
+const obj = (description) => ({ type: "object", ...(description ? { description } : {}) });
+const arr = (description, items) => ({
+    type: "array",
+    ...(items ? { items } : {}),
+    ...(description ? { description } : {}),
+});
+/** A field that is an object when present and `null` when there is nothing to report. */
+const objOrNull = (description) => ({ type: ["object", "null"], description });
+function schema(required, properties) {
+    for (const key of required) {
+        if (!(key in properties))
+            throw new Error(`output schema: required field "${key}" is not described`);
+    }
+    return { type: "object", properties, required, additionalProperties: true };
+}
+const STEP = obj("One transaction to send, in order: target, calldata, value in wei, and gas when the step needs an explicit limit.");
+export const OUTPUT_SCHEMAS = {
+    get_treasury_state: schema(["nav_usd", "eth_price_usd", "nav_reliable", "management_fee_bps_per_year", "auction_open", "crash_shield_active", "basket"], {
+        nav_usd: num("Net asset value of one GBLIN share in USD."),
+        eth_price_usd: num("ETH price in USD from the oracle."),
+        nav_reliable: bool("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: num("Management fee in basis points per year, read from the contract."),
+        auction_open: bool("True while a rebalancing auction is running."),
+        crash_shield_active: bool("True when the crash shield has cut the weight of a falling asset."),
+        slippage_buffer_pct: num(),
+        slippage_reason: str(),
+        basket: arr("Assets in the basket with base and dynamic weights.", obj()),
+        meta: obj(),
+    }),
+    quote_safe_swap: schema(["direction", "slippage_buffer_bps", "next_step"], {
+        direction: { type: "string", enum: ["buy", "sell"] },
+        amount_in_eth: str("Buy only."),
+        expected_gblin_out: str("Buy only."),
+        safe_min_gblin_out: str("Buy only. Pass as minOut."),
+        amount_in_gblin: str("Sell only."),
+        expected_eth_out: str("Sell only."),
+        safe_min_eth_out: str("Sell only. Pass as minEthOut."),
+        fees: obj(),
+        slippage_buffer_bps: num(),
+        slippage_reason: str(),
+        will_revert_with_zero_tolerance: bool(),
+        cooldown_note: str(),
+        next_step: str(),
+    }),
+    swap_gblin_to_usdc_jit: schema(["action", "steps", "expected", "gas_hint"], {
+        action: str("Always sequential_txs: send the steps one after the other."),
+        steps: arr("Transactions to send in order.", STEP),
+        params: obj(),
+        expected: obj("Shares spent, ETH and USDC expected, and the minimums applied."),
+        compatibility: obj(),
+        gas_hint: num("Gas limit to set on the Zap step."),
+        gas_hint_note: str(),
+    }),
+    invest_usdc_to_gblin: schema(["action", "steps", "expected", "gas_hint"], {
+        action: str("Always sequential_txs: send the steps one after the other."),
+        steps: arr("Transactions to send in order.", STEP),
+        gas_hint: num("Gas limit to set on the Zap step."),
+        gas_hint_note: str(),
+        expected: obj("Shares expected and the minimum applied."),
+        security: obj(),
+    }),
+    analyze_treasury_health: schema(["wallet", "balances", "gas_health", "cooldown", "recommendation"], {
+        wallet: str(),
+        balances: obj(),
+        ratios: obj(),
+        gas_health: obj("Whether the wallet holds enough ETH for the next transactions."),
+        cooldown: obj("Whether the redemption cooldown is active and for how long."),
+        recommendation: obj("hold, rebalance_to_gblin or rebalance_to_usdc, with the reason."),
+    }),
+    get_governance_state: schema(["vault", "owner", "owner_is_timelock", "owner_is_renounced", "timelock"], {
+        vault: str(),
+        lens: str(),
+        owner: str(),
+        owner_is_timelock: bool(),
+        owner_is_renounced: bool(),
+        fee_recipient: str(),
+        trust_summary: str(),
+        timelock: obj("Address and minimum delay of the timelock, read on chain."),
+        pending_handover: objOrNull("A pending ownership transfer, or null."),
+        pending_timelock_operation: objOrNull("A scheduled timelock operation affecting ownership, or null."),
+        verification: obj(),
+    }),
+    share_skill_with_peer: schema(["text"], {
+        text: str("A ready-to-send description of the GBLIN skill."),
+    }),
+    get_auction_state: schema(["vault", "navReliable", "auctionOpen", "premiumBps", "rows"], {
+        vault: str(),
+        lens: str(),
+        navReliable: bool(),
+        auctionOpen: bool(),
+        premiumBps: num("Current premium over the oracle price, in basis points; negative is a discount."),
+        curve: obj(),
+        openedAt: { type: ["number", "string", "null"], description: "When the auction opened, or null when closed." },
+        worstGapEth: str(),
+        totalValueEth: str(),
+        rows: arr("One entry per basket asset: side, gap from target and amount a bidder can fill.", obj()),
+        best: objOrNull("The row with the largest gap, or null."),
+        howToBid: str(),
+        note: str(),
+    }),
+    get_market_risk_regime: schema(["regime", "severity_pct", "shield_active", "defensive_cash_pct"], {
+        regime: { type: "string", enum: ["calm", "elevated", "crash"] },
+        risk_posture: str(),
+        severity_pct: num(),
+        shield_active: bool(),
+        defensive_cash_pct: num(),
+        assets: arr(undefined, obj()),
+        source: str(),
+        verify: str(),
+        meta: obj(),
+    }),
+    verify_risk_attestation: schema(["valid", "checks"], {
+        valid: bool("True only if every check passed."),
+        checks: obj("Each check by name, with its result."),
+        attested: obj(),
+        live: obj(),
+        recomputed_attestation_id: str(),
+        guidance: str(),
+        source: str(),
+    }),
+    get_receipt: schema(["index", "payload", "signature", "inclusion_proof"], {
+        format: str(),
+        payload: obj("The sealed record as signed."),
+        leaf: str(),
+        index: num(),
+        tree_size: num(),
+        root: str(),
+        signature: str(),
+        verifier_key: str(),
+        inclusion_proof: arr("Sibling hashes from the leaf to the root (RFC 6962).", { type: "string" }),
+        checkpoint: str(),
+        anchor: obj(),
+        provenance: obj(),
+        canonical_sha256: str(),
+        canonicalization: obj("The canonical JSON form the leaf is hashed from."),
+        verify: str("How to verify this receipt."),
+        note: str(),
+        human_page: str(),
+        verify_offline: str(),
+    }),
+    how_to_seal_paid: schema(["endpoint", "price", "flow"], {
+        endpoint: str(),
+        price: str(),
+        flow: str(),
+        body_schema: obj(),
+        receipt: str(),
+        read_free: str(),
+        verify_offline: str(),
+        note: str(),
+    }),
+    prepare_gblin_payment: schema(["authorization", "method", "typed_data", "digest", "x402_payload"], {
+        authorization: obj("from, to, value, validAfter, validBefore, nonce."),
+        method: { type: "string", enum: ["receive", "transfer"] },
+        typed_data: obj("The EIP-712 message to sign with eth_signTypedData_v4."),
+        digest: str("The EIP-712 digest of typed_data."),
+        amount: obj(),
+        payer_balance: obj(),
+        next_steps: arr(undefined, { type: "string" }),
+        submit: obj(),
+        x402_payload: obj("The x402 exact-scheme payment payload, with the signature left to fill."),
+        x402_accepts_for_sellers: obj(),
+        relay: obj("With relay: true, the fee authorization to sign and where to send both."),
+        warnings: arr(undefined, { type: "string" }),
+    }),
+    prepare_action: schema(["action", "steps"], {
+        action: str(),
+        wallet: str(),
+        steps: arr("Transactions to send in order.", STEP),
+        expected: obj("What the operation should deliver, with the minimums applied."),
+        warnings: arr(undefined, { type: "string" }),
+        next: str(),
+    }),
+    preview_steps: schema(["would_succeed", "steps", "balance_changes"], {
+        would_succeed: bool("True only if every step succeeds in the simulation."),
+        from: str(),
+        block: num("The block the simulation ran on."),
+        steps: arr("Per step: success, gas used, whether the given limit is enough, recommended limit, revert reason.", obj()),
+        first_failing_step: { type: ["number", "null"] },
+        balance_changes: arr("Net token and ETH movements for the wallet.", obj()),
+        note: str(),
+    }),
+    get_transaction_status: schema(["hash", "status"], {
+        hash: str(),
+        status: { type: "string", enum: ["pending", "not_found", "success", "reverted"] },
+        block: num(),
+        confirmations: num(),
+        from: str(),
+        to: { type: ["string", "null"] },
+        gas_used: num(),
+        gas_limit: { type: ["number", "null"] },
+        fee_eth: str(),
+        balance_changes: arr(undefined, obj()),
+        revert: obj(),
+        explorer: str(),
+        note: str(),
+    }),
+    get_nav_history: schema(["interval", "points", "series"], {
+        interval: { type: "string", enum: ["hour", "day"] },
+        points: num(),
+        series: arr("Oldest first: time, block, NAV in ETH and USD, ETH/USD and BTC/USD.", obj()),
+        summary: objOrNull("Change of NAV, ETH and BTC over the window, and the NAV's largest drawdown."),
+        note: str(),
+        method: str(),
+    }),
+    relay_gblin_payment: schema(["relay", "status", "transaction"], {
+        relay: str("The relay that carried the payment."),
+        status: { type: "string", enum: ["settled", "reverted", "submitted"] },
+        transaction: str("The transaction hash."),
+        explorer: str(),
+        payment: obj(),
+        fee: obj(),
+        block: num(),
+        note: str(),
+    }),
+    verify_gblin_authorization: schema(["would_settle", "method", "checks", "failures"], {
+        would_settle: bool("True only if the token would accept this authorization now."),
+        method: { type: "string", enum: ["receive", "transfer"] },
+        digest: str(),
+        checks: obj(),
+        failures: arr("Reasons it would not settle; empty when it would.", { type: "string" }),
+        amount: obj(),
+        submit: objOrNull("Calldata and who may submit it, or null when it would not settle."),
+        source: str(),
+    }),
+};
+//# sourceMappingURL=output-schemas.js.map

package/dist/output-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.js","sourceRoot":"","sources":["../src/output-schemas.ts"],"names":[],"mappings":"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"}

package/dist/payments.d.ts

@@ -0,0 +1,170 @@
+/**
+ * GBLIN MCP — paying in GBLIN with a signature (EIP-3009).
+ *
+ * The vault's share token implements EIP-3009, the same mechanism USDC uses: the holder signs an
+ * authorization and anybody can carry it on chain, so the holder never needs ETH for gas. These two
+ * tools cover the two halves of that exchange.
+ *
+ *   prepare_gblin_payment      → builds the EIP-712 message to sign, the calldata that carries it,
+ *                                and the x402 payment payload for a paid HTTP endpoint.
+ *   verify_gblin_authorization → checks a signed authorization against the chain before anyone
+ *                                spends gas submitting it.
+ *   relay_gblin_payment        → hands a signed payment and a signed relay fee to GBLIN's relay, which
+ *                                carries both in one transaction for a payer that holds no ETH.
+ *
+ * Neither tool holds, asks for or transmits a private key. The signature is produced by the caller's
+ * own wallet from the typed data returned here.
+ *
+ * Shapes follow the x402 "exact" scheme so an authorization built here is accepted by any x402
+ * facilitator, not only by GBLIN's own endpoints.
+ */
+import { type Address, type Hex } from "viem";
+export interface Eip712Domain {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: Address;
+}
+/**
+ * Reads the EIP-712 domain from the token itself (EIP-5267) instead of assuming it.
+ * The domain is part of what a signature commits to: a wrong name or version produces a signature
+ * that every verifier rejects, and the failure only shows up at settlement.
+ */
+export declare function getTokenDomain(): Promise<Eip712Domain>;
+export interface Authorization {
+    from: Address;
+    to: Address;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: Hex;
+}
+export declare const PREPARE_PAYMENT_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            from: {
+                type: string;
+                description: string;
+            };
+            to: {
+                type: string;
+                description: string;
+            };
+            amount_gblin: {
+                type: string;
+                description: string;
+            };
+            amount_usd: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            valid_for_seconds: {
+                type: string;
+                description: string;
+            };
+            relay: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function handlePreparePayment(args: Record<string, unknown>): Promise<unknown>;
+export declare const RELAY_PAYMENT_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            payment: {
+                type: string;
+                description: string;
+                properties: {
+                    authorization: {
+                        type: string;
+                    };
+                    signature: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+                required: string[];
+            };
+            fee: {
+                type: string;
+                description: string;
+                properties: {
+                    authorization: {
+                        type: string;
+                    };
+                    signature: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+                required: string[];
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function handleRelayPayment(args: Record<string, unknown>): Promise<unknown>;
+export declare const VERIFY_AUTHORIZATION_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            authorization: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+            signature: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function handleVerifyAuthorization(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=payments.d.ts.map

package/dist/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAQL,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAyCd,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAc5D;AAqBD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC;CACZ;AA6CD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoChC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkJ1F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B9B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBxF;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BrC,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiI/F"}