@suisei-mcp/mcp 0.1.0

package/dist/tools/sui_get_validators_apy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Current APY for every active validator, as the network computes it from
+ * recent epoch rewards. Read-only. This is the APR/APY feed a staking app
+ * shows to help a user pick a validator before sui_stake.
+ *
+ * Returns apy as a fraction (0.041 = 4.1%) plus apy_percent for display.
+ * Pass `validator` to get a single one, `sort` to rank highest-first, and
+ * `limit` to cap the list.
+ */
+export declare function suiGetValidatorsApy(raw: unknown): Promise<string>;

package/dist/tools/sui_get_validators_apy.js

@@ -0,0 +1,37 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Current APY for every active validator, as the network computes it from
+ * recent epoch rewards. Read-only. This is the APR/APY feed a staking app
+ * shows to help a user pick a validator before sui_stake.
+ *
+ * Returns apy as a fraction (0.041 = 4.1%) plus apy_percent for display.
+ * Pass `validator` to get a single one, `sort` to rank highest-first, and
+ * `limit` to cap the list.
+ */
+export async function suiGetValidatorsApy(raw) {
+    const { network, validator, limit, sort } = raw;
+    const client = clientFor(network);
+    const { epoch, apys } = await client.getValidatorsApy();
+    let rows = apys.map((a) => ({
+        validator_address: a.address,
+        apy: a.apy,
+        apy_percent: Number((a.apy * 100).toFixed(4)),
+    }));
+    if (validator) {
+        rows = rows.filter((r) => r.validator_address === validator);
+    }
+    if (sort) {
+        rows.sort((x, y) => y.apy - x.apy);
+    }
+    if (typeof limit === 'number') {
+        rows = rows.slice(0, limit);
+    }
+    return JSON.stringify({
+        network,
+        epoch,
+        validator_count: rows.length,
+        validators: rows,
+        note: 'apy is a fraction (0.041 = 4.1%). Newly-onboarded validators may report apy 0 until they have reward history.',
+    });
+}
+//# sourceMappingURL=sui_get_validators_apy.js.map

package/dist/tools/sui_get_validators_apy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_validators_apy.js","sourceRoot":"","sources":["../../src/tools/sui_get_validators_apy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAS3D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAY;IACpD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAW,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAExD,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,iBAAiB,EAAE,CAAC,CAAC,OAAO;QAC5B,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC9C,CAAC,CAAC,CAAC;IAEJ,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,KAAK;QACL,eAAe,EAAE,IAAI,CAAC,MAAM;QAC5B,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,+GAA+G;KACtH,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_mint_badge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build (do not execute) a PTB that calls the canonical Suisei badge
+ * mint entry. Returns base64 transaction bytes that the caller can
+ * hand to a signer. Why "build, not execute": MCP tools should not
+ * spend the user's gas without an explicit signing step.
+ */
+export declare function suiMintBadge(raw: unknown): Promise<string>;

package/dist/tools/sui_mint_badge.js

@@ -0,0 +1,35 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not execute) a PTB that calls the canonical Suisei badge
+ * mint entry. Returns base64 transaction bytes that the caller can
+ * hand to a signer. Why "build, not execute": MCP tools should not
+ * spend the user's gas without an explicit signing step.
+ */
+export async function suiMintBadge(raw) {
+    const { recipient, quest_id, quest_number, badge_package, network } = raw;
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${badge_package}::badge::mint`,
+        arguments: [
+            tx.pure.address(recipient),
+            tx.pure.vector('u8', Array.from(new TextEncoder().encode(quest_id))),
+            tx.pure.u8(quest_number),
+            tx.object('0x6'),
+        ],
+    });
+    tx.setSender(recipient);
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        target: `${badge_package}::badge::mint`,
+        recipient,
+        quest_id,
+        quest_number,
+        network,
+        next_step: 'Dry-run with sui_dry_run, then sign and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=sui_mint_badge.js.map

package/dist/tools/sui_mint_badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_mint_badge.js","sourceRoot":"","sources":["../../src/tools/sui_mint_badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAUtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAClF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,QAAQ,CAAC;QACV,MAAM,EAAE,GAAG,aAAa,eAAe;QACvC,SAAS,EAAE;YACT,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC1B,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACpE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC;YACxB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SACjB;KACF,CAAC,CAAC;IACH,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAExB,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,MAAM,EAAE,GAAG,aAAa,eAAe;QACvC,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,SAAS,EACP,4EAA4E;KAC/E,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_move_call.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Build (do not sign) a transaction that calls ANY Move entry function.
+ * This is the universal write primitive — the generic form of every
+ * purpose-built mint/transfer tool.
+ *
+ * Each argument is a string in one of these forms:
+ *   - `object:<id>`              an owned/shared object by id
+ *   - `pure:address:<0x..>`
+ *   - `pure:id:<0x..>`
+ *   - `pure:bool:<true|false>`
+ *   - `pure:string:<text>`
+ *   - `pure:u8|u16|u32|u64|u128|u256:<number>`
+ *
+ * Vector and nested-struct arguments are intentionally out of scope for
+ * the generic tool — write a dedicated tool for those so the schema
+ * stays unambiguous for the calling agent.
+ */
+export declare function suiMoveCall(raw: unknown): Promise<string>;

package/dist/tools/sui_move_call.js

@@ -0,0 +1,88 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a transaction that calls ANY Move entry function.
+ * This is the universal write primitive — the generic form of every
+ * purpose-built mint/transfer tool.
+ *
+ * Each argument is a string in one of these forms:
+ *   - `object:<id>`              an owned/shared object by id
+ *   - `pure:address:<0x..>`
+ *   - `pure:id:<0x..>`
+ *   - `pure:bool:<true|false>`
+ *   - `pure:string:<text>`
+ *   - `pure:u8|u16|u32|u64|u128|u256:<number>`
+ *
+ * Vector and nested-struct arguments are intentionally out of scope for
+ * the generic tool — write a dedicated tool for those so the schema
+ * stays unambiguous for the calling agent.
+ */
+export async function suiMoveCall(raw) {
+    const { target, type_arguments, arguments: args, sender, network } = raw;
+    if (!/^0x[0-9a-fA-F]+::[A-Za-z_][\w]*::[A-Za-z_][\w]*$/.test(target)) {
+        throw new Error(`Bad target "${target}": expected "0xpkg::module::function".`);
+    }
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.moveCall({
+        target,
+        typeArguments: type_arguments,
+        arguments: args.map((a) => applyMoveArg(tx, a)),
+    });
+    tx.setSender(sender);
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        target,
+        type_arguments,
+        sender,
+        network,
+        next_step: 'Dry-run with sui_dry_run, then sign and submit with sui_execute_signed_tx.',
+    });
+}
+function applyMoveArg(tx, arg) {
+    const firstColon = arg.indexOf(':');
+    if (firstColon === -1) {
+        throw new Error(`Bad argument "${arg}": expected "object:<id>" or "pure:<type>:<value>".`);
+    }
+    const kind = arg.slice(0, firstColon);
+    if (kind === 'object') {
+        return tx.object(arg.slice(firstColon + 1));
+    }
+    if (kind === 'pure') {
+        const rest = arg.slice(firstColon + 1);
+        const sep = rest.indexOf(':');
+        if (sep === -1) {
+            throw new Error(`Bad pure argument "${arg}": expected "pure:<type>:<value>".`);
+        }
+        const type = rest.slice(0, sep);
+        const value = rest.slice(sep + 1);
+        switch (type) {
+            case 'address':
+                return tx.pure.address(value);
+            case 'id':
+                return tx.pure.id(value);
+            case 'bool':
+                return tx.pure.bool(value === 'true');
+            case 'string':
+                return tx.pure.string(value);
+            case 'u8':
+                return tx.pure.u8(Number(value));
+            case 'u16':
+                return tx.pure.u16(Number(value));
+            case 'u32':
+                return tx.pure.u32(Number(value));
+            case 'u64':
+                return tx.pure.u64(BigInt(value));
+            case 'u128':
+                return tx.pure.u128(BigInt(value));
+            case 'u256':
+                return tx.pure.u256(BigInt(value));
+            default:
+                throw new Error(`Unsupported pure type "${type}" in "${arg}".`);
+        }
+    }
+    throw new Error(`Unknown argument kind "${kind}" in "${arg}".`);
+}
+//# sourceMappingURL=sui_move_call.js.map

package/dist/tools/sui_move_call.js.map

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

package/dist/tools/sui_pay_many.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build (do not sign) a many-to-many SUI payout in a single PTB: split N
+ * coins out of gas and send each to its matching recipient. Powers
+ * airdrops, payroll, batch refunds, splitter contracts.
+ *
+ * recipients and amounts_mist must be the same length and same order:
+ * amounts_mist[i] goes to recipients[i]. Amounts are MIST strings to avoid
+ * precision loss.
+ */
+export declare function suiPayMany(raw: unknown): Promise<string>;

package/dist/tools/sui_pay_many.js

@@ -0,0 +1,40 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a many-to-many SUI payout in a single PTB: split N
+ * coins out of gas and send each to its matching recipient. Powers
+ * airdrops, payroll, batch refunds, splitter contracts.
+ *
+ * recipients and amounts_mist must be the same length and same order:
+ * amounts_mist[i] goes to recipients[i]. Amounts are MIST strings to avoid
+ * precision loss.
+ */
+export async function suiPayMany(raw) {
+    const { sender, network, recipients, amounts_mist } = raw;
+    if (recipients.length === 0)
+        throw new Error('recipients is empty.');
+    if (recipients.length !== amounts_mist.length) {
+        throw new Error(`recipients (${recipients.length}) and amounts_mist (${amounts_mist.length}) must be the same length.`);
+    }
+    const tx = new Transaction();
+    tx.setSender(sender);
+    const splits = tx.splitCoins(tx.gas, amounts_mist.map((a) => tx.pure.u64(BigInt(a))));
+    // splitCoins returns an array of TransactionResult handles, one per amount.
+    recipients.forEach((r, i) => {
+        tx.transferObjects([splits[i]], tx.pure.address(r));
+    });
+    const client = clientFor(network);
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    const total = amounts_mist.reduce((acc, x) => acc + BigInt(x), 0n).toString();
+    return JSON.stringify({
+        tx_bytes_base64,
+        sender,
+        network,
+        payout_count: recipients.length,
+        total_mist: total,
+        total_sui: Number(BigInt(total)) / 1e9,
+        next_step: 'Dry-run with sui_dry_run, sign, and submit with sui_execute_signed_tx. All N payouts settle atomically — they all land or none do.',
+    });
+}
+//# sourceMappingURL=sui_pay_many.js.map

package/dist/tools/sui_pay_many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_pay_many.js","sourceRoot":"","sources":["../../src/tools/sui_pay_many.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY;IAC3C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,GAAW,CAAC;IAClE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,MAAM,uBAAuB,YAAY,CAAC,MAAM,4BAA4B,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAErB,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAC1B,EAAE,CAAC,GAAG,EACN,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;IACF,4EAA4E;IAC5E,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,EAAE,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9E,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,MAAM;QACN,OAAO;QACP,YAAY,EAAE,UAAU,CAAC,MAAM;QAC/B,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG;QACtC,SAAS,EACP,oIAAoI;KACvI,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_query_events.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Query historical events. Powers reactive agents: react to swaps on a
+ * pool, badge mints, NFT transfers — anything that emits a Move event.
+ * Filter by full event_type, by Move module (package + module — both
+ * required together), by sender, or by transaction. Paginated; pass back
+ * next_cursor_* to continue.
+ *
+ * Sui's event index requires at least one filter; an unfiltered scan
+ * would return the whole chain. Package-only filtering is not supported
+ * by the fullnode — pair package with module.
+ */
+export declare function suiQueryEvents(raw: unknown): Promise<string>;

package/dist/tools/sui_query_events.js

@@ -0,0 +1,59 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Query historical events. Powers reactive agents: react to swaps on a
+ * pool, badge mints, NFT transfers — anything that emits a Move event.
+ * Filter by full event_type, by Move module (package + module — both
+ * required together), by sender, or by transaction. Paginated; pass back
+ * next_cursor_* to continue.
+ *
+ * Sui's event index requires at least one filter; an unfiltered scan
+ * would return the whole chain. Package-only filtering is not supported
+ * by the fullnode — pair package with module.
+ */
+export async function suiQueryEvents(raw) {
+    const a = raw;
+    const client = clientFor(a.network);
+    // Build the EventFilter discriminated union the SDK expects.
+    let query;
+    if (a.event_type)
+        query = { MoveEventType: a.event_type };
+    else if (a.module && a.package)
+        query = { MoveModule: { package: a.package, module: a.module } };
+    else if (a.sender)
+        query = { Sender: a.sender };
+    else if (a.transaction)
+        query = { Transaction: a.transaction };
+    else if (a.package && !a.module) {
+        throw new Error('package alone is not a supported event filter. Pass module too (MoveModule = package + module), or use event_type / sender / transaction.');
+    }
+    else {
+        throw new Error('Pass at least one filter: event_type, package+module, sender, or transaction.');
+    }
+    const cursor = a.cursor_tx_digest && a.cursor_event_seq
+        ? { txDigest: a.cursor_tx_digest, eventSeq: a.cursor_event_seq }
+        : null;
+    const res = await client.queryEvents({
+        query: query,
+        cursor,
+        limit: a.limit,
+        order: a.descending === false ? 'ascending' : 'descending',
+    });
+    return JSON.stringify({
+        network: a.network,
+        count: res.data.length,
+        has_next_page: res.hasNextPage,
+        next_cursor_tx_digest: res.nextCursor?.txDigest ?? null,
+        next_cursor_event_seq: res.nextCursor?.eventSeq ?? null,
+        events: res.data.map((e) => ({
+            tx_digest: e.id.txDigest,
+            event_seq: e.id.eventSeq,
+            type: e.type,
+            package: e.packageId,
+            module: e.transactionModule,
+            sender: e.sender,
+            timestamp_ms: e.timestampMs,
+            parsed_json: e.parsedJson,
+        })),
+    });
+}
+//# sourceMappingURL=sui_query_events.js.map

package/dist/tools/sui_query_events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_query_events.js","sourceRoot":"","sources":["../../src/tools/sui_query_events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAgB3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY;IAC/C,MAAM,CAAC,GAAG,GAAW,CAAC;IACtB,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEpC,6DAA6D;IAC7D,IAAI,KAA8B,CAAC;IACnC,IAAI,CAAC,CAAC,UAAU;QAAE,KAAK,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;SACrD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,GAAG,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC5F,IAAI,CAAC,CAAC,MAAM;QAAE,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC3C,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;SAC1D,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,2IAA2I,CAC5I,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,gBAAgB;QACtC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC,gBAAgB,EAAE;QAChE,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACnC,KAAK,EAAE,KAA0D;QACjE,MAAM;QACN,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;KAC3D,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;QACtB,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,qBAAqB,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,IAAI,IAAI;QACvD,qBAAqB,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,IAAI,IAAI;QACvD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ;YACxB,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ;YACxB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,SAAS;YACpB,MAAM,EAAE,CAAC,CAAC,iBAAiB;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,YAAY,EAAE,CAAC,CAAC,WAAW;YAC3B,WAAW,EAAE,CAAC,CAAC,UAAU;SAC1B,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_resolve_address.d.ts

@@ -0,0 +1,6 @@
+/**
+ * If the input is a 0x address, return it canonicalized. Otherwise
+ * treat it as a SuiNS name and resolve. Reasoning: tools should never
+ * fail just because the user gave the input it expected anyway.
+ */
+export declare function suiResolveAddress(raw: unknown): Promise<string>;

package/dist/tools/sui_resolve_address.js

@@ -0,0 +1,22 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * If the input is a 0x address, return it canonicalized. Otherwise
+ * treat it as a SuiNS name and resolve. Reasoning: tools should never
+ * fail just because the user gave the input it expected anyway.
+ */
+export async function suiResolveAddress(raw) {
+    const { name_or_address, network } = raw;
+    if (/^0x[0-9a-fA-F]+$/.test(name_or_address)) {
+        return JSON.stringify({
+            address: name_or_address.toLowerCase(),
+            source: 'literal',
+        });
+    }
+    const client = clientFor(network);
+    const result = await client.resolveNameServiceAddress({ name: name_or_address });
+    if (!result) {
+        throw new Error(`SuiNS name not found: ${name_or_address}`);
+    }
+    return JSON.stringify({ address: result, source: 'suins', name: name_or_address });
+}
+//# sourceMappingURL=sui_resolve_address.js.map

package/dist/tools/sui_resolve_address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_resolve_address.js","sourceRoot":"","sources":["../../src/tools/sui_resolve_address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACjD,IAAI,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,eAAe,CAAC,WAAW,EAAE;YACtC,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,eAAe,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/tools/sui_resolve_coin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve a coin symbol (e.g. "USDC", "DEEP", "SUI") to its fully-qualified
+ * coin type on the chosen network. Without a symbol, lists every known
+ * symbol — useful when the agent isn't sure what's available.
+ *
+ * This is the coin-side mirror of sui_resolve_address: stops the agent
+ * from hallucinating coin types ("oh USDC must be 0x2::usdc::USDC right?").
+ */
+export declare function suiResolveCoin(raw: unknown): Promise<string>;

package/dist/tools/sui_resolve_coin.js

@@ -0,0 +1,26 @@
+import { COINS, findCoin, knownSymbols } from '../coins.js';
+/**
+ * Resolve a coin symbol (e.g. "USDC", "DEEP", "SUI") to its fully-qualified
+ * coin type on the chosen network. Without a symbol, lists every known
+ * symbol — useful when the agent isn't sure what's available.
+ *
+ * This is the coin-side mirror of sui_resolve_address: stops the agent
+ * from hallucinating coin types ("oh USDC must be 0x2::usdc::USDC right?").
+ */
+export async function suiResolveCoin(raw) {
+    const { network, symbol } = raw;
+    if (!symbol) {
+        const table = COINS[network] ?? {};
+        return JSON.stringify({
+            network,
+            known_symbols: knownSymbols(network),
+            coins: Object.values(table),
+        });
+    }
+    const info = findCoin(network, symbol);
+    if (!info) {
+        throw new Error(`Unknown symbol "${symbol}" on ${network}. Known: ${knownSymbols(network).join(', ') || 'none'}. Pass the full coin_type to any tool to use a coin not in the registry.`);
+    }
+    return JSON.stringify({ network, ...info });
+}
+//# sourceMappingURL=sui_resolve_coin.js.map

package/dist/tools/sui_resolve_coin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_resolve_coin.js","sourceRoot":"","sources":["../../src/tools/sui_resolve_coin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY;IAC/C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAW,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO;YACP,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC;YACpC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,QAAQ,OAAO,YAAY,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,0EAA0E,CACzK,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/tools/sui_stake.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build (do not sign) a native staking transaction: split `amount_mist`
+ * from gas and delegate it to `validator` via 0x3::sui_system. The host
+ * signs and submits; the resulting StakedSui object lands in the sender.
+ */
+export declare function suiStake(raw: unknown): Promise<string>;

package/dist/tools/sui_stake.js

@@ -0,0 +1,29 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a native staking transaction: split `amount_mist`
+ * from gas and delegate it to `validator` via 0x3::sui_system. The host
+ * signs and submits; the resulting StakedSui object lands in the sender.
+ */
+export async function suiStake(raw) {
+    const { sender, amount_mist, validator, network } = raw;
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.setSender(sender);
+    const [stakeCoin] = tx.splitCoins(tx.gas, [tx.pure.u64(BigInt(amount_mist))]);
+    tx.moveCall({
+        target: '0x3::sui_system::request_add_stake',
+        arguments: [tx.object('0x5'), stakeCoin, tx.pure.address(validator)],
+    });
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        sender,
+        amount_mist,
+        validator,
+        network,
+        next_step: 'Sign and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=sui_stake.js.map

package/dist/tools/sui_stake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_stake.js","sourceRoot":"","sources":["../../src/tools/sui_stake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAY;IACzC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAChE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,EAAE,CAAC,QAAQ,CAAC;QACV,MAAM,EAAE,oCAAoC;QAC5C,SAAS,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KACrE,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,MAAM;QACN,WAAW;QACX,SAAS;QACT,OAAO;QACP,SAAS,EAAE,6CAA6C;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_transfer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build (do not sign) a transfer. Provide `amount_mist` to send SUI
+ * (split from the gas coin) and/or `object_ids` to send whole objects.
+ */
+export declare function suiTransfer(raw: unknown): Promise<string>;

package/dist/tools/sui_transfer.js

@@ -0,0 +1,34 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a transfer. Provide `amount_mist` to send SUI
+ * (split from the gas coin) and/or `object_ids` to send whole objects.
+ */
+export async function suiTransfer(raw) {
+    const { sender, recipient, amount_mist, object_ids, network } = raw;
+    if (!amount_mist && !(object_ids && object_ids.length > 0)) {
+        throw new Error('Nothing to transfer: provide amount_mist and/or object_ids.');
+    }
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.setSender(sender);
+    if (amount_mist) {
+        const [coin] = tx.splitCoins(tx.gas, [tx.pure.u64(BigInt(amount_mist))]);
+        tx.transferObjects([coin], tx.pure.address(recipient));
+    }
+    if (object_ids && object_ids.length > 0) {
+        tx.transferObjects(object_ids.map((id) => tx.object(id)), tx.pure.address(recipient));
+    }
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        sender,
+        recipient,
+        amount_mist: amount_mist ?? null,
+        object_ids: object_ids ?? [],
+        network,
+        next_step: 'Sign and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=sui_transfer.js.map

package/dist/tools/sui_transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_transfer.js","sourceRoot":"","sources":["../../src/tools/sui_transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAUtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY;IAC5C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC5E,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAErB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,EAAE,CAAC,eAAe,CAChB,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EACrC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,MAAM;QACN,SAAS;QACT,WAAW,EAAE,WAAW,IAAI,IAAI;QAChC,UAAU,EAAE,UAAU,IAAI,EAAE;QAC5B,OAAO;QACP,SAAS,EAAE,6CAA6C;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_unstake.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build (do not sign) a withdraw-stake transaction for a StakedSui
+ * object. Returns principal plus earned rewards to the sender when the
+ * host signs and submits.
+ */
+export declare function suiUnstake(raw: unknown): Promise<string>;

package/dist/tools/sui_unstake.js

@@ -0,0 +1,27 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a withdraw-stake transaction for a StakedSui
+ * object. Returns principal plus earned rewards to the sender when the
+ * host signs and submits.
+ */
+export async function suiUnstake(raw) {
+    const { sender, staked_sui_id, network } = raw;
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.setSender(sender);
+    tx.moveCall({
+        target: '0x3::sui_system::request_withdraw_stake',
+        arguments: [tx.object('0x5'), tx.object(staked_sui_id)],
+    });
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        sender,
+        staked_sui_id,
+        network,
+        next_step: 'Sign and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=sui_unstake.js.map

package/dist/tools/sui_unstake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_unstake.js","sourceRoot":"","sources":["../../src/tools/sui_unstake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAQtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY;IAC3C,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACvD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,EAAE,CAAC,QAAQ,CAAC;QACV,MAAM,EAAE,yCAAyC;QACjD,SAAS,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;KACxD,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,MAAM;QACN,aAAa;QACb,OAAO;QACP,SAAS,EAAE,6CAA6C;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/walrus_fetch.d.ts

@@ -0,0 +1 @@
+export declare function walrusFetch(raw: unknown): Promise<string>;

package/dist/tools/walrus_fetch.js

@@ -0,0 +1,18 @@
+const DEFAULT_AGGREGATOR = 'https://aggregator.walrus-testnet.walrus.space';
+export async function walrusFetch(raw) {
+    const { blob_id, as, aggregator_url } = raw;
+    const url = `${aggregator_url ?? DEFAULT_AGGREGATOR}/v1/blobs/${blob_id}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Walrus aggregator returned ${res.status} for ${blob_id}`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    const content = as === 'base64' ? buf.toString('base64') : buf.toString('utf8');
+    return JSON.stringify({
+        blob_id,
+        encoding: as,
+        size_bytes: buf.length,
+        content,
+    });
+}
+//# sourceMappingURL=walrus_fetch.js.map

package/dist/tools/walrus_fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus_fetch.js","sourceRoot":"","sources":["../../src/tools/walrus_fetch.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,gDAAgD,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY;IAC5C,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,GAAW,CAAC;IACpD,MAAM,GAAG,GAAG,GAAG,cAAc,IAAI,kBAAkB,aAAa,OAAO,EAAE,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,QAAQ,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,GACX,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,GAAG,CAAC,MAAM;QACtB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/walrus_publish.d.ts

@@ -0,0 +1 @@
+export declare function walrusPublish(raw: unknown): Promise<string>;

package/dist/tools/walrus_publish.js

@@ -0,0 +1,42 @@
+const DEFAULT_PUBLISHER = 'https://publisher.walrus-testnet.walrus.space';
+export async function walrusPublish(raw) {
+    const { content, encoding, epochs, publisher_url } = raw;
+    const body = encoding === 'base64'
+        ? Buffer.from(content, 'base64')
+        : Buffer.from(content, 'utf8');
+    const url = `${publisher_url ?? DEFAULT_PUBLISHER}/v1/blobs?epochs=${epochs}`;
+    // Buffer is a Uint8Array subclass, which fetch accepts as a body.
+    const res = await fetch(url, {
+        method: 'PUT',
+        body: new Uint8Array(body),
+    });
+    if (!res.ok) {
+        throw new Error(`Walrus publisher returned ${res.status}: ${await res.text()}`);
+    }
+    const data = (await res.json());
+    // Walrus returns one of: { newlyCreated: { blobObject: {...} } } or
+    // { alreadyCertified: { blobId, ... } }. Normalize.
+    let blobId;
+    let kind = 'unknown';
+    const newly = data.newlyCreated;
+    const already = data.alreadyCertified;
+    if (newly?.blobObject?.blobId) {
+        blobId = newly.blobObject.blobId;
+        kind = 'newly_created';
+    }
+    else if (already?.blobId) {
+        blobId = already.blobId;
+        kind = 'already_certified';
+    }
+    if (!blobId) {
+        throw new Error(`Walrus response missing blobId: ${JSON.stringify(data)}`);
+    }
+    return JSON.stringify({
+        blob_id: blobId,
+        status: kind,
+        epochs,
+        publisher: publisher_url ?? DEFAULT_PUBLISHER,
+        size_bytes: body.length,
+    });
+}
+//# sourceMappingURL=walrus_publish.js.map