suprafx-agent-sdk 0.3.1

package/dist/src/signer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Delegate signer: encapsulates the ed25519 key + sequence counter,
+ * encodes a SupraFX event, signs it, and submits to the dApp ingress.
+ *
+ * Designed for an agent process that holds ONE delegate key. To run
+ * multiple delegates (e.g. one per pair) instantiate one Signer each.
+ *
+ * Sequence management:
+ *   - On construct, takeOff with `loadSequenceFromChain()` to align
+ *     the counter to the chain's current expectation
+ *   - On a `body.ok === true` submit: counter advances by 1
+ *   - On `body.ok === false` with code in `CHAIN_SAW_IT_CODES`:
+ *     counter advances (the chain saw the bad envelope and consumed
+ *     the seq slot for replay protection)
+ *   - On `body.ok === false` with ingress codes (decode_error,
+ *     rate_limited, missing_envelope): counter unchanged, safe to retry
+ *
+ * The chain rejects sequence-number replays at vote time silently —
+ * the dApp's submit returns HTTP 200 from mempool but the trade
+ * never commits. Re-fetch via `loadSequenceFromChain()` on any
+ * suspected drift to recover.
+ */
+import { type UserEvent } from "./event-bcs.js";
+import { SupraFxClient, type SubmitResult } from "./client.js";
+export interface DelegateSignerOptions {
+    /** 32-byte ed25519 private key as hex (with or without 0x prefix). */
+    delegatePrivKeyHex: string;
+    /** The dApp HTTP client. Reused for reads + writes. */
+    client: SupraFxClient;
+}
+export declare class DelegateSigner {
+    private readonly priv;
+    private readonly pub;
+    /** 32-byte Supra address = sha3_256(pubkey || 0x00). */
+    readonly address: Uint8Array;
+    /** Address as `0x`-prefixed lowercase hex. */
+    readonly addressHex: string;
+    private readonly client;
+    private nextSeq;
+    private chainIdHash;
+    constructor(opts: DelegateSignerOptions);
+    /** Re-anchor the local sequence counter to the chain's expectation.
+     *  Call on startup, on uncertainty, and after long network gaps. */
+    loadSequenceFromChain(): Promise<bigint>;
+    /** Cached lookup of the chain id hash (constant per genesis). */
+    private ensureChainIdHash;
+    /** Current next-sequence-number this signer would use. Exposed
+     *  for diagnostics and for adapters that need to forward seq into
+     *  custom event payloads. */
+    getNextSeq(): bigint;
+    /**
+     * Build a signed envelope from `event` and submit it to the
+     * matching dApp endpoint. Returns the raw `SubmitResult` plus the
+     * envelope bytes (handy for logging or replaying).
+     *
+     * The caller MUST pass an event whose `payload.*sequence_number*`
+     * matches `this.getNextSeq()` — we don't mutate the payload here
+     * because the field name differs by event type (`user_sequence_number`
+     * on most, etc.). Helper methods below (`placeQuote`, `submitRfq`,
+     * etc.) handle this for you.
+     */
+    sendEnvelope(event: UserEvent): Promise<SubmitResult & {
+        envelopeBcsHex: string;
+    }>;
+    submitRfq(payload: Omit<Extract<UserEvent, {
+        kind: "SubmitRfq";
+    }>["payload"], "user_sequence_number" | "user">): Promise<SubmitResult>;
+    placeQuote(payload: Omit<Extract<UserEvent, {
+        kind: "PlaceQuote";
+    }>["payload"], "user_sequence_number" | "maker">): Promise<SubmitResult>;
+    /** CancelRfq has no `user_sequence_number` — rfq_id uniqueness is
+     *  the replay-protection invariant. The signer doesn't advance the
+     *  seq counter for this event type. */
+    cancelRfq(args: {
+        rfq_id: Uint8Array;
+        reason: string;
+    }): Promise<SubmitResult>;
+    /** AcceptQuote: takes `quote_id` + `trade_id` (caller-supplied, used
+     *  as the on-chain trade identity). Does NOT take `rfq_id`. */
+    acceptQuote(args: {
+        quote_id: Uint8Array;
+        trade_id: Uint8Array;
+    }): Promise<SubmitResult>;
+    /** WithdrawQuote takes only `quote_id`. No sequence number — quote_id
+     *  uniqueness is the replay-protection invariant. */
+    withdrawQuote(args: {
+        quote_id: Uint8Array;
+    }): Promise<SubmitResult>;
+}

package/dist/src/signer.js

@@ -0,0 +1,226 @@
+/**
+ * Delegate signer: encapsulates the ed25519 key + sequence counter,
+ * encodes a SupraFX event, signs it, and submits to the dApp ingress.
+ *
+ * Designed for an agent process that holds ONE delegate key. To run
+ * multiple delegates (e.g. one per pair) instantiate one Signer each.
+ *
+ * Sequence management:
+ *   - On construct, takeOff with `loadSequenceFromChain()` to align
+ *     the counter to the chain's current expectation
+ *   - On a `body.ok === true` submit: counter advances by 1
+ *   - On `body.ok === false` with code in `CHAIN_SAW_IT_CODES`:
+ *     counter advances (the chain saw the bad envelope and consumed
+ *     the seq slot for replay protection)
+ *   - On `body.ok === false` with ingress codes (decode_error,
+ *     rate_limited, missing_envelope): counter unchanged, safe to retry
+ *
+ * The chain rejects sequence-number replays at vote time silently —
+ * the dApp's submit returns HTTP 200 from mempool but the trade
+ * never commits. Re-fetch via `loadSequenceFromChain()` on any
+ * suspected drift to recover.
+ */
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { sha3_256 } from "@noble/hashes/sha3.js";
+import { encodeUserEvent, } from "./event-bcs.js";
+import { composeSignBytes, encodeEnvelopeBcs, } from "./sign-event.js";
+/** Codes that mean the chain accepted the envelope at mempool but
+ *  rejected it at apply-time. The seq slot is consumed either way. */
+const CHAIN_SAW_IT_CODES = new Set([
+    "gate_rejected",
+    "auth_failed",
+]);
+/**
+ * The event kinds that actually CARRY a `user_sequence_number` in their
+ * BCS payload, and therefore consume a sequence slot on chain.
+ *
+ * WHY THIS GATE EXISTS. `CancelRfq` and `WithdrawQuote` have no
+ * `user_sequence_number` field at all (see `event-bcs.ts`
+ * `CancelRfqEvent` / `WithdrawQuoteEvent`) — their replay protection is
+ * the uniqueness of `rfq_id` / `quote_id`. But `sendEnvelope` used to
+ * advance `nextSeq` on ANY `ok === true`, so a single cancel or quote
+ * withdrawal pushed the local counter one ahead of the chain's. Every
+ * later trade then signed a seq the chain had already consumed, and the
+ * chain drops a replayed seq SILENTLY — `ok:true` at ingress, never
+ * committed. One cancel desynced every trade after it until reconnect.
+ */
+const CONSUMES_SEQ = new Set([
+    "SubmitRfq",
+    "PlaceQuote",
+    "AcceptQuote",
+]);
+export class DelegateSigner {
+    priv;
+    pub;
+    /** 32-byte Supra address = sha3_256(pubkey || 0x00). */
+    address;
+    /** Address as `0x`-prefixed lowercase hex. */
+    addressHex;
+    client;
+    nextSeq;
+    chainIdHash = null;
+    constructor(opts) {
+        this.priv = hexToBytes(stripHex(opts.delegatePrivKeyHex));
+        if (this.priv.length !== 32) {
+            throw new Error(`delegatePrivKeyHex must be 32 bytes (got ${this.priv.length})`);
+        }
+        this.pub = ed25519.getPublicKey(this.priv);
+        const addrInput = new Uint8Array(this.pub.length + 1);
+        addrInput.set(this.pub, 0);
+        addrInput[this.pub.length] = 0x00;
+        this.address = sha3_256(addrInput);
+        this.addressHex = "0x" + bytesToHex(this.address);
+        this.client = opts.client;
+        this.nextSeq = BigInt(0); // overwritten by loadSequenceFromChain()
+    }
+    /** Re-anchor the local sequence counter to the chain's expectation.
+     *  Call on startup, on uncertainty, and after long network gaps. */
+    async loadSequenceFromChain() {
+        const next = await this.client.getSequenceNumber(this.addressHex);
+        this.nextSeq = BigInt(next);
+        return this.nextSeq;
+    }
+    /** Cached lookup of the chain id hash (constant per genesis). */
+    async ensureChainIdHash() {
+        if (this.chainIdHash)
+            return this.chainIdHash;
+        const ci = await this.client.getChainInfo();
+        this.chainIdHash = hexToBytes(stripHex(ci.chainIdHashHex));
+        return this.chainIdHash;
+    }
+    /** Current next-sequence-number this signer would use. Exposed
+     *  for diagnostics and for adapters that need to forward seq into
+     *  custom event payloads. */
+    getNextSeq() {
+        return this.nextSeq;
+    }
+    /**
+     * Build a signed envelope from `event` and submit it to the
+     * matching dApp endpoint. Returns the raw `SubmitResult` plus the
+     * envelope bytes (handy for logging or replaying).
+     *
+     * The caller MUST pass an event whose `payload.*sequence_number*`
+     * matches `this.getNextSeq()` — we don't mutate the payload here
+     * because the field name differs by event type (`user_sequence_number`
+     * on most, etc.). Helper methods below (`placeQuote`, `submitRfq`,
+     * etc.) handle this for you.
+     */
+    async sendEnvelope(event) {
+        const chainIdHash = await this.ensureChainIdHash();
+        const eventBcs = encodeUserEvent(event);
+        const signBytes = composeSignBytes(chainIdHash, eventBcs);
+        const sig = ed25519.sign(signBytes, this.priv);
+        const envelopeBcs = encodeEnvelopeBcs({
+            event_bcs: eventBcs,
+            signer_pubkey: this.pub,
+            signer_sig: sig,
+        });
+        const envelopeBcsHex = bytesToHex(envelopeBcs);
+        const { endpoint, bodyField } = routeForEvent(event.kind);
+        const res = await this.client.submitEnvelope(endpoint, bodyField, envelopeBcsHex);
+        // Only seq-BEARING events may move the counter. A cancel/withdraw
+        // returning ok:true must leave it exactly where it was.
+        if (CONSUMES_SEQ.has(event.kind)) {
+            if (res.ok === true) {
+                this.nextSeq = this.nextSeq + 1n;
+            }
+            else if (res.code && CHAIN_SAW_IT_CODES.has(res.code)) {
+                // Chain saw the envelope but rejected. Seq slot is consumed.
+                this.nextSeq = this.nextSeq + 1n;
+            }
+            // Otherwise (ingress-level reject): seq unchanged.
+        }
+        return { ...res, envelopeBcsHex };
+    }
+    // ─── Convenience methods that build the event + send ──────────
+    async submitRfq(payload) {
+        return await this.sendEnvelope({
+            kind: "SubmitRfq",
+            payload: {
+                user: this.address,
+                ...payload,
+                user_sequence_number: this.nextSeq,
+            },
+        });
+    }
+    async placeQuote(payload) {
+        return await this.sendEnvelope({
+            kind: "PlaceQuote",
+            payload: {
+                maker: this.address,
+                ...payload,
+                user_sequence_number: this.nextSeq,
+            },
+        });
+    }
+    /** CancelRfq has no `user_sequence_number` — rfq_id uniqueness is
+     *  the replay-protection invariant. The signer doesn't advance the
+     *  seq counter for this event type. */
+    async cancelRfq(args) {
+        return await this.sendEnvelope({
+            kind: "CancelRfq",
+            payload: {
+                user: this.address,
+                rfq_id: args.rfq_id,
+                reason: args.reason,
+            },
+        });
+    }
+    /** AcceptQuote: takes `quote_id` + `trade_id` (caller-supplied, used
+     *  as the on-chain trade identity). Does NOT take `rfq_id`. */
+    async acceptQuote(args) {
+        return await this.sendEnvelope({
+            kind: "AcceptQuote",
+            payload: {
+                taker: this.address,
+                quote_id: args.quote_id,
+                trade_id: args.trade_id,
+                user_sequence_number: this.nextSeq,
+            },
+        });
+    }
+    /** WithdrawQuote takes only `quote_id`. No sequence number — quote_id
+     *  uniqueness is the replay-protection invariant. */
+    async withdrawQuote(args) {
+        return await this.sendEnvelope({
+            kind: "WithdrawQuote",
+            payload: {
+                maker: this.address,
+                quote_id: args.quote_id,
+            },
+        });
+    }
+}
+function routeForEvent(kind) {
+    switch (kind) {
+        case "SubmitRfq":
+            return { endpoint: "submit-rfq", bodyField: "submit_rfq_envelope_bcs_hex" };
+        case "PlaceQuote":
+            return { endpoint: "place-quote", bodyField: "place_quote_envelope_bcs_hex" };
+        case "AcceptQuote":
+            return { endpoint: "accept-quote", bodyField: "accept_quote_envelope_bcs_hex" };
+        case "WithdrawQuote":
+            return { endpoint: "withdraw-quote", bodyField: "withdraw_quote_envelope_bcs_hex" };
+        case "CancelRfq":
+            return { endpoint: "cancel-rfq", bodyField: "cancel_rfq_envelope_bcs_hex" };
+        default:
+            throw new Error(`routeForEvent: no endpoint for event kind ${kind}`);
+    }
+}
+function stripHex(s) {
+    return (s.startsWith("0x") || s.startsWith("0X") ? s.slice(2) : s).toLowerCase();
+}
+function hexToBytes(s) {
+    const stripped = stripHex(s);
+    if (stripped.length % 2 !== 0)
+        throw new Error("hex length must be even");
+    const out = new Uint8Array(stripped.length / 2);
+    for (let i = 0; i < out.length; i++) {
+        out[i] = parseInt(stripped.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out;
+}
+function bytesToHex(b) {
+    return Array.from(b, (x) => x.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=signer.js.map

package/dist/src/signer.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "suprafx-agent-sdk",
+  "version": "0.3.1",
+  "description": "SDK + MCP server for building autonomous agents on SupraFX",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jtobkin/suprafx-agent-sdk.git"
+  },
+  "homepage": "https://suprafx.ai/agents",
+  "bin": {
+    "suprafx-mcp": "dist/bin/suprafx-mcp.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./signer": {
+      "import": "./dist/src/signer.js",
+      "types": "./dist/src/signer.d.ts"
+    },
+    "./client": {
+      "import": "./dist/src/client.js",
+      "types": "./dist/src/client.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "mcp": "node dist/bin/suprafx-mcp.js",
+    "test": "npx tsx --test test/*.test.ts src/mcp/*.test.ts"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@noble/curves": "^1.6.0",
+    "@noble/hashes": "^1.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eventsource": "^3.0.7",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "suprafx",
+    "mcp",
+    "model-context-protocol",
+    "trading",
+    "ai-agent",
+    "market-maker",
+    "bft"
+  ]
+}