@suisei-mcp/mcp 0.1.0

package/dist/tools/sui_get_all_balances.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Every coin balance an address holds, not just SUI. Use this when the
+ * wallet might own tokens beyond the native coin.
+ */
+export declare function suiGetAllBalances(raw: unknown): Promise<string>;

package/dist/tools/sui_get_all_balances.js

@@ -0,0 +1,21 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Every coin balance an address holds, not just SUI. Use this when the
+ * wallet might own tokens beyond the native coin.
+ */
+export async function suiGetAllBalances(raw) {
+    const { address, network } = raw;
+    const client = clientFor(network);
+    const balances = await client.getAllBalances({ owner: address });
+    return JSON.stringify({
+        address,
+        network,
+        count: balances.length,
+        balances: balances.map((b) => ({
+            coin_type: b.coinType,
+            total_mist: b.totalBalance,
+            coin_object_count: b.coinObjectCount,
+        })),
+    });
+}
+//# sourceMappingURL=sui_get_all_balances.js.map

package/dist/tools/sui_get_all_balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_all_balances.js","sourceRoot":"","sources":["../../src/tools/sui_get_all_balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAEjE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,OAAO;QACP,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,SAAS,EAAE,CAAC,CAAC,QAAQ;YACrB,UAAU,EAAE,CAAC,CAAC,YAAY;YAC1B,iBAAiB,EAAE,CAAC,CAAC,eAAe;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_balance.d.ts

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

package/dist/tools/sui_get_balance.js

@@ -0,0 +1,17 @@
+import { clientFor } from '../sui-client.js';
+export async function suiGetBalance(raw) {
+    const { address, network } = raw;
+    const client = clientFor(network);
+    const balance = await client.getBalance({ owner: address });
+    const mist = BigInt(balance.totalBalance);
+    const sui = Number(mist) / 1e9;
+    return JSON.stringify({
+        address,
+        network,
+        coin_type: balance.coinType,
+        total_mist: balance.totalBalance,
+        total_sui: sui,
+        coin_object_count: balance.coinObjectCount,
+    });
+}
+//# sourceMappingURL=sui_get_balance.js.map

package/dist/tools/sui_get_balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_balance.js","sourceRoot":"","sources":["../../src/tools/sui_get_balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAY;IAC9C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,QAAQ;QAC3B,UAAU,EAAE,OAAO,CAAC,YAAY;QAChC,SAAS,EAAE,GAAG;QACd,iBAAiB,EAAE,OAAO,CAAC,eAAe;KAC3C,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_coin_metadata.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Live coin metadata: symbol, name, decimals, description, icon URL. Pass
+ * coin_type (e.g. "0x2::sui::SUI") or symbol (e.g. "USDC"). With symbol,
+ * the local registry resolves to a coin_type first — this works even when
+ * the on-chain CoinMetadata is absent or slow.
+ *
+ * Decimals are critical for every DeFi flow: a "5 USDC" transfer is 5e6
+ * smallest units (6 decimals), not 5e9.
+ */
+export declare function suiGetCoinMetadata(raw: unknown): Promise<string>;

package/dist/tools/sui_get_coin_metadata.js

@@ -0,0 +1,38 @@
+import { clientFor } from '../sui-client.js';
+import { findCoin } from '../coins.js';
+/**
+ * Live coin metadata: symbol, name, decimals, description, icon URL. Pass
+ * coin_type (e.g. "0x2::sui::SUI") or symbol (e.g. "USDC"). With symbol,
+ * the local registry resolves to a coin_type first — this works even when
+ * the on-chain CoinMetadata is absent or slow.
+ *
+ * Decimals are critical for every DeFi flow: a "5 USDC" transfer is 5e6
+ * smallest units (6 decimals), not 5e9.
+ */
+export async function suiGetCoinMetadata(raw) {
+    const a = raw;
+    let coinType = a.coin_type;
+    if (!coinType && a.symbol) {
+        const known = findCoin(a.network, a.symbol);
+        if (!known) {
+            throw new Error(`Unknown symbol "${a.symbol}" on ${a.network}. Pass coin_type explicitly or use sui_resolve_coin.`);
+        }
+        coinType = known.coin_type;
+    }
+    if (!coinType)
+        throw new Error('Pass coin_type or symbol.');
+    const client = clientFor(a.network);
+    const meta = await client.getCoinMetadata({ coinType });
+    const fromRegistry = findCoin(a.network, a.symbol ?? meta?.symbol ?? '');
+    return JSON.stringify({
+        network: a.network,
+        coin_type: coinType,
+        decimals: meta?.decimals ?? fromRegistry?.decimals ?? null,
+        symbol: meta?.symbol ?? fromRegistry?.symbol ?? null,
+        name: meta?.name ?? null,
+        description: meta?.description ?? fromRegistry?.description ?? null,
+        icon_url: meta?.iconUrl ?? null,
+        note: 'Multiply human amounts by 10^decimals to get smallest-unit values that every transfer / swap / stake tool expects.',
+    });
+}
+//# sourceMappingURL=sui_get_coin_metadata.js.map

package/dist/tools/sui_get_coin_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_coin_metadata.js","sourceRoot":"","sources":["../../src/tools/sui_get_coin_metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAY;IACnD,MAAM,CAAC,GAAG,GAAW,CAAC;IACtB,IAAI,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC;IAE3B,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,mBAAmB,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,OAAO,sDAAsD,CACnG,CAAC;QACJ,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IAEzE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,IAAI;QAC1D,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,IAAI,IAAI;QACpD,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QACxB,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,YAAY,EAAE,WAAW,IAAI,IAAI;QACnE,QAAQ,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC/B,IAAI,EACF,oHAAoH;KACvH,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_coins.d.ts

@@ -0,0 +1,6 @@
+/**
+ * List individual coin objects of one type held by an address. Unlike
+ * sui_get_balance (which sums), this returns the concrete coin object ids
+ * an agent needs to pass into a sui_move_call or split. Paginated.
+ */
+export declare function suiGetCoins(raw: unknown): Promise<string>;

package/dist/tools/sui_get_coins.js

@@ -0,0 +1,31 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * List individual coin objects of one type held by an address. Unlike
+ * sui_get_balance (which sums), this returns the concrete coin object ids
+ * an agent needs to pass into a sui_move_call or split. Paginated.
+ */
+export async function suiGetCoins(raw) {
+    const { address, coin_type, cursor, limit, network } = raw;
+    const client = clientFor(network);
+    const res = await client.getCoins({
+        owner: address,
+        coinType: coin_type, // undefined → native 0x2::sui::SUI
+        cursor: cursor ?? null,
+        limit,
+    });
+    return JSON.stringify({
+        address,
+        network,
+        coin_type: coin_type ?? '0x2::sui::SUI',
+        count: res.data.length,
+        has_next_page: res.hasNextPage,
+        next_cursor: res.nextCursor ?? null,
+        coins: res.data.map((c) => ({
+            coin_object_id: c.coinObjectId,
+            balance: c.balance,
+            version: c.version,
+            digest: c.digest,
+        })),
+    });
+}
+//# sourceMappingURL=sui_get_coins.js.map

package/dist/tools/sui_get_coins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_coins.js","sourceRoot":"","sources":["../../src/tools/sui_get_coins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAU3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAY;IAC5C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;QAChC,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,SAAS,EAAE,mCAAmC;QACxD,MAAM,EAAE,MAAM,IAAI,IAAI;QACtB,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,OAAO;QACP,SAAS,EAAE,SAAS,IAAI,eAAe;QACvC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;QACtB,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,WAAW,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QACnC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,cAAc,EAAE,CAAC,CAAC,YAAY;YAC9B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_dynamic_fields.d.ts

@@ -0,0 +1,6 @@
+/**
+ * List the dynamic fields attached to a parent object — the way Sui
+ * stores Tables, Bags, and other on-chain collections. Returns each
+ * field's name, type, and the child object id. Paginated.
+ */
+export declare function suiGetDynamicFields(raw: unknown): Promise<string>;

package/dist/tools/sui_get_dynamic_fields.js

@@ -0,0 +1,30 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * List the dynamic fields attached to a parent object — the way Sui
+ * stores Tables, Bags, and other on-chain collections. Returns each
+ * field's name, type, and the child object id. Paginated.
+ */
+export async function suiGetDynamicFields(raw) {
+    const { parent_id, cursor, limit, network } = raw;
+    const client = clientFor(network);
+    const res = await client.getDynamicFields({
+        parentId: parent_id,
+        cursor: cursor ?? null,
+        limit,
+    });
+    return JSON.stringify({
+        parent_id,
+        network,
+        count: res.data.length,
+        has_next_page: res.hasNextPage,
+        next_cursor: res.nextCursor ?? null,
+        fields: res.data.map((f) => ({
+            name: f.name,
+            type: f.type,
+            object_type: f.objectType,
+            object_id: f.objectId,
+            digest: f.digest,
+        })),
+    });
+}
+//# sourceMappingURL=sui_get_dynamic_fields.js.map

package/dist/tools/sui_get_dynamic_fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_dynamic_fields.js","sourceRoot":"","sources":["../../src/tools/sui_get_dynamic_fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAS3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAY;IACpD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;QACxC,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,MAAM,IAAI,IAAI;QACtB,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,SAAS;QACT,OAAO;QACP,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;QACtB,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,WAAW,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QACnC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,UAAU;YACzB,SAAS,EAAE,CAAC,CAAC,QAAQ;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_object.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Read any on-chain object's type, owner, content fields and Display.
+ * The general primitive every other read tool is a special case of.
+ */
+export declare function suiGetObject(raw: unknown): Promise<string>;

package/dist/tools/sui_get_object.js

@@ -0,0 +1,37 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Read any on-chain object's type, owner, content fields and Display.
+ * The general primitive every other read tool is a special case of.
+ */
+export async function suiGetObject(raw) {
+    const { object_id, network } = raw;
+    const client = clientFor(network);
+    const res = await client.getObject({
+        id: object_id,
+        options: {
+            showType: true,
+            showOwner: true,
+            showContent: true,
+            showDisplay: true,
+        },
+    });
+    if (res.error) {
+        throw new Error(`Object ${object_id} not readable: ${JSON.stringify(res.error)}`);
+    }
+    const data = res.data;
+    const content = data?.content;
+    const fields = content && content.dataType === 'moveObject'
+        ? content.fields
+        : null;
+    return JSON.stringify({
+        object_id,
+        network,
+        type: data?.type,
+        version: data?.version,
+        digest: data?.digest,
+        owner: data?.owner,
+        fields,
+        display: data?.display?.data ?? null,
+    });
+}
+//# sourceMappingURL=sui_get_object.js.map

package/dist/tools/sui_get_object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_object.js","sourceRoot":"","sources":["../../src/tools/sui_get_object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;QACjC,EAAE,EAAE,SAAS;QACb,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,IAAI;SAClB;KACF,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;IAC9B,MAAM,MAAM,GACV,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,YAAY;QAC1C,CAAC,CAAE,OAAO,CAAC,MAAkC;QAC7C,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,SAAS;QACT,OAAO;QACP,IAAI,EAAE,IAAI,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI,EAAE,OAAO;QACtB,MAAM,EAAE,IAAI,EAAE,MAAM;QACpB,KAAK,EAAE,IAAI,EAAE,KAAK;QAClB,MAAM;QACN,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_owned_badges.d.ts

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

package/dist/tools/sui_get_owned_badges.js

@@ -0,0 +1,64 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Canonical Suisei badge packages per network. Hardcode the published id
+ * here after running scripts/publish-badge.sh so the tool works with no
+ * arguments. Until then, callers can set the SUISEI_BADGE_PACKAGE env var
+ * or pass `badge_package` explicitly.
+ */
+const DEFAULT_BADGE_PACKAGE = {
+// testnet: '0x…',  // paste published package id here
+// mainnet: '0x…',
+};
+export async function suiGetOwnedBadges(raw) {
+    const { address, badge_package, network } = raw;
+    const pkg = badge_package ??
+        process.env.SUISEI_BADGE_PACKAGE ??
+        DEFAULT_BADGE_PACKAGE[network];
+    if (!pkg) {
+        throw new Error(`No badge package for ${network}. Set SUISEI_BADGE_PACKAGE, pass badge_package, or hardcode DEFAULT_BADGE_PACKAGE.`);
+    }
+    const client = clientFor(network);
+    const badgeType = `${pkg}::badge::Badge`;
+    const owned = await client.getOwnedObjects({
+        owner: address,
+        filter: { StructType: badgeType },
+        options: { showContent: true, showType: true },
+    });
+    const badges = (owned.data ?? [])
+        .map((o) => {
+        const content = o.data?.content;
+        const fields = content && content.dataType === 'moveObject'
+            ? content.fields
+            : null;
+        return {
+            object_id: o.data?.objectId,
+            type: o.data?.type,
+            quest_id: bytesFieldToString(fields?.quest_id),
+            quest_number: fields?.quest_number,
+            minted_at_ms: fields?.minted_at_ms,
+        };
+    })
+        .filter((b) => !!b.object_id);
+    return JSON.stringify({
+        address,
+        badge_package: pkg,
+        network,
+        count: badges.length,
+        badges,
+    });
+}
+/** Move byte-vector fields come back as either string or number[]. Normalize. */
+function bytesFieldToString(field) {
+    if (typeof field === 'string')
+        return field;
+    if (Array.isArray(field)) {
+        try {
+            return new TextDecoder().decode(new Uint8Array(field));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=sui_get_owned_badges.js.map

package/dist/tools/sui_get_owned_badges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_owned_badges.js","sourceRoot":"","sources":["../../src/tools/sui_get_owned_badges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAQ3D;;;;;GAKG;AACH,MAAM,qBAAqB,GAAqC;AAC9D,sDAAsD;AACtD,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACxD,MAAM,GAAG,GACP,aAAa;QACb,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,oFAAoF,CACpH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,GAAG,gBAAgB,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QACzC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;QACjC,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC;QAChC,MAAM,MAAM,GACV,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,YAAY;YAC1C,CAAC,CAAE,OAAO,CAAC,MAAkC;YAC7C,CAAC,CAAC,IAAI,CAAC;QACX,OAAO;YACL,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;YAClB,QAAQ,EAAE,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC9C,YAAY,EAAE,MAAM,EAAE,YAAY;YAClC,YAAY,EAAE,MAAM,EAAE,YAAY;SACnC,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,aAAa,EAAE,GAAG;QAClB,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAiB,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/tools/sui_get_owned_objects.d.ts

@@ -0,0 +1,5 @@
+/**
+ * List objects owned by an address, optionally filtered to one Move
+ * struct type. Paginated: pass the returned `next_cursor` to continue.
+ */
+export declare function suiGetOwnedObjects(raw: unknown): Promise<string>;

package/dist/tools/sui_get_owned_objects.js

@@ -0,0 +1,32 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * List objects owned by an address, optionally filtered to one Move
+ * struct type. Paginated: pass the returned `next_cursor` to continue.
+ */
+export async function suiGetOwnedObjects(raw) {
+    const { address, struct_type, cursor, limit, network } = raw;
+    const client = clientFor(network);
+    const res = await client.getOwnedObjects({
+        owner: address,
+        filter: struct_type ? { StructType: struct_type } : undefined,
+        cursor: cursor ?? null,
+        limit,
+        options: { showType: true },
+    });
+    const objects = (res.data ?? []).map((o) => ({
+        object_id: o.data?.objectId,
+        type: o.data?.type,
+        version: o.data?.version,
+        digest: o.data?.digest,
+    }));
+    return JSON.stringify({
+        address,
+        network,
+        struct_type: struct_type ?? null,
+        count: objects.length,
+        has_next_page: res.hasNextPage,
+        next_cursor: res.nextCursor ?? null,
+        objects,
+    });
+}
+//# sourceMappingURL=sui_get_owned_objects.js.map

package/dist/tools/sui_get_owned_objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_owned_objects.js","sourceRoot":"","sources":["../../src/tools/sui_get_owned_objects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAU3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAY;IACnD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACrE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QACvC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QAC7D,MAAM,EAAE,MAAM,IAAI,IAAI;QACtB,KAAK;QACL,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC5B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;QAClB,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO;QACxB,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM;KACvB,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,OAAO;QACP,WAAW,EAAE,WAAW,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,WAAW,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QACnC,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_reference_gas_price.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Current reference gas price (in MIST) for the network. An agent can use
+ * it to estimate fees or set a gas price before building a transaction.
+ */
+export declare function suiGetReferenceGasPrice(raw: unknown): Promise<string>;

package/dist/tools/sui_get_reference_gas_price.js

@@ -0,0 +1,15 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Current reference gas price (in MIST) for the network. An agent can use
+ * it to estimate fees or set a gas price before building a transaction.
+ */
+export async function suiGetReferenceGasPrice(raw) {
+    const { network } = raw;
+    const client = clientFor(network);
+    const price = await client.getReferenceGasPrice();
+    return JSON.stringify({
+        network,
+        reference_gas_price_mist: price.toString(),
+    });
+}
+//# sourceMappingURL=sui_get_reference_gas_price.js.map

package/dist/tools/sui_get_reference_gas_price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_reference_gas_price.js","sourceRoot":"","sources":["../../src/tools/sui_get_reference_gas_price.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAM3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAY;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAChC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,oBAAoB,EAAE,CAAC;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,wBAAwB,EAAE,KAAK,CAAC,QAAQ,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_stakes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * List an address's active native stakes, grouped by validator. For each
+ * StakedSui the chain returns the principal, the (estimated) rewards
+ * accrued so far, and the activation epoch — everything a staking app
+ * needs to show "you staked X, you've earned Y". Read-only: no gas, no
+ * signing.
+ *
+ * Pair with sui_get_validators_apy to project forward returns, and
+ * sui_unstake (which takes a staked_sui_id from here) to withdraw.
+ */
+export declare function suiGetStakes(raw: unknown): Promise<string>;

package/dist/tools/sui_get_stakes.js

@@ -0,0 +1,54 @@
+import { clientFor } from '../sui-client.js';
+const toSui = (mist) => Number(BigInt(mist)) / 1e9;
+/**
+ * List an address's active native stakes, grouped by validator. For each
+ * StakedSui the chain returns the principal, the (estimated) rewards
+ * accrued so far, and the activation epoch — everything a staking app
+ * needs to show "you staked X, you've earned Y". Read-only: no gas, no
+ * signing.
+ *
+ * Pair with sui_get_validators_apy to project forward returns, and
+ * sui_unstake (which takes a staked_sui_id from here) to withdraw.
+ */
+export async function suiGetStakes(raw) {
+    const { address, network } = raw;
+    const client = clientFor(network);
+    const delegated = await client.getStakes({ owner: address });
+    let totalPrincipalMist = 0n;
+    let totalRewardMist = 0n;
+    const validators = delegated.map((d) => {
+        const stakes = d.stakes.map((s) => {
+            const principal = BigInt(s.principal);
+            const reward = BigInt('estimatedReward' in s && s.estimatedReward ? s.estimatedReward : '0');
+            totalPrincipalMist += principal;
+            totalRewardMist += reward;
+            return {
+                staked_sui_id: s.stakedSuiId,
+                status: s.status,
+                stake_active_epoch: s.stakeActiveEpoch,
+                stake_request_epoch: s.stakeRequestEpoch,
+                principal_mist: s.principal,
+                principal_sui: toSui(s.principal),
+                estimated_reward_mist: 'estimatedReward' in s && s.estimatedReward ? s.estimatedReward : null,
+                estimated_reward_sui: 'estimatedReward' in s && s.estimatedReward ? toSui(s.estimatedReward) : null,
+            };
+        });
+        return {
+            validator_address: d.validatorAddress,
+            staking_pool: d.stakingPool,
+            stakes,
+        };
+    });
+    return JSON.stringify({
+        address,
+        network,
+        validator_count: validators.length,
+        total_principal_mist: totalPrincipalMist.toString(),
+        total_principal_sui: toSui(totalPrincipalMist),
+        total_estimated_reward_mist: totalRewardMist.toString(),
+        total_estimated_reward_sui: toSui(totalRewardMist),
+        validators,
+        note: 'estimated_reward is only populated for stakes that are Active (rewards begin the epoch after activation). Use staked_sui_id with sui_unstake to withdraw.',
+    });
+}
+//# sourceMappingURL=sui_get_stakes.js.map

package/dist/tools/sui_get_stakes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_stakes.js","sourceRoot":"","sources":["../../src/tools/sui_get_stakes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D,MAAM,KAAK,GAAG,CAAC,IAA8B,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAE7D,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAC5B,IAAI,eAAe,GAAG,EAAE,CAAC;IAEzB,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7F,kBAAkB,IAAI,SAAS,CAAC;YAChC,eAAe,IAAI,MAAM,CAAC;YAC1B,OAAO;gBACL,aAAa,EAAE,CAAC,CAAC,WAAW;gBAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,kBAAkB,EAAE,CAAC,CAAC,gBAAgB;gBACtC,mBAAmB,EAAE,CAAC,CAAC,iBAAiB;gBACxC,cAAc,EAAE,CAAC,CAAC,SAAS;gBAC3B,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjC,qBAAqB,EACnB,iBAAiB,IAAI,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;gBACxE,oBAAoB,EAClB,iBAAiB,IAAI,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI;aAChF,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO;YACL,iBAAiB,EAAE,CAAC,CAAC,gBAAgB;YACrC,YAAY,EAAE,CAAC,CAAC,WAAW;YAC3B,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,OAAO;QACP,eAAe,EAAE,UAAU,CAAC,MAAM;QAClC,oBAAoB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACnD,mBAAmB,EAAE,KAAK,CAAC,kBAAkB,CAAC;QAC9C,2BAA2B,EAAE,eAAe,CAAC,QAAQ,EAAE;QACvD,0BAA0B,EAAE,KAAK,CAAC,eAAe,CAAC;QAClD,UAAU;QACV,IAAI,EACF,2JAA2J;KAC9J,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_transaction.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fetch a finalized transaction by digest: status, gas, balance changes,
+ * and event count. Use to inspect the result of a tx submitted earlier
+ * (the same digest sui_execute_signed_tx returns).
+ */
+export declare function suiGetTransaction(raw: unknown): Promise<string>;

package/dist/tools/sui_get_transaction.js

@@ -0,0 +1,26 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Fetch a finalized transaction by digest: status, gas, balance changes,
+ * and event count. Use to inspect the result of a tx submitted earlier
+ * (the same digest sui_execute_signed_tx returns).
+ */
+export async function suiGetTransaction(raw) {
+    const { digest, network } = raw;
+    const client = clientFor(network);
+    const res = await client.getTransactionBlock({
+        digest,
+        options: { showEffects: true, showEvents: true, showBalanceChanges: true },
+    });
+    return JSON.stringify({
+        digest: res.digest,
+        network,
+        status: res.effects?.status.status ?? 'unknown',
+        error: res.effects?.status.error ?? null,
+        timestamp_ms: res.timestampMs ?? null,
+        checkpoint: res.checkpoint ?? null,
+        gas_used: res.effects?.gasUsed ?? null,
+        balance_changes: res.balanceChanges ?? [],
+        events_count: res.events?.length ?? 0,
+    });
+}
+//# sourceMappingURL=sui_get_transaction.js.map

package/dist/tools/sui_get_transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_transaction.js","sourceRoot":"","sources":["../../src/tools/sui_get_transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC;QAC3C,MAAM;QACN,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE;KAC3E,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO;QACP,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;QAC/C,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QACxC,YAAY,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;QACrC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QAClC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;QACtC,eAAe,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACzC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_validator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * One validator's full picture, with APY merged: name, address, commission,
+ * total stake, voting power, project URL — plus the live APY the chain
+ * computes from recent epoch rewards. Fuses sui_get_validators and
+ * sui_get_validators_apy into a single read so a staking app doesn't have
+ * to join them by hand.
+ */
+export declare function suiGetValidator(raw: unknown): Promise<string>;

package/dist/tools/sui_get_validator.js

@@ -0,0 +1,43 @@
+import { clientFor } from '../sui-client.js';
+const toSui = (mist) => Number(BigInt(mist)) / 1e9;
+/**
+ * One validator's full picture, with APY merged: name, address, commission,
+ * total stake, voting power, project URL — plus the live APY the chain
+ * computes from recent epoch rewards. Fuses sui_get_validators and
+ * sui_get_validators_apy into a single read so a staking app doesn't have
+ * to join them by hand.
+ */
+export async function suiGetValidator(raw) {
+    const { validator_address, network } = raw;
+    const client = clientFor(network);
+    const [state, apys] = await Promise.all([
+        client.getLatestSuiSystemState(),
+        client.getValidatorsApy(),
+    ]);
+    const v = state.activeValidators.find((x) => x.suiAddress === validator_address);
+    if (!v) {
+        throw new Error(`Validator ${validator_address} not in the active set on ${network} (epoch ${state.epoch}). Use sui_get_validators to list.`);
+    }
+    const apyRow = apys.apys.find((a) => a.address === validator_address);
+    const apy = apyRow?.apy ?? null;
+    return JSON.stringify({
+        network,
+        epoch: state.epoch,
+        name: v.name,
+        validator_address: v.suiAddress,
+        description: v.description,
+        image_url: v.imageUrl,
+        project_url: v.projectUrl,
+        commission_rate_bps: Number(v.commissionRate),
+        commission_percent: Number(v.commissionRate) / 100,
+        staking_pool_id: v.stakingPoolId,
+        staking_pool_sui_balance_mist: v.stakingPoolSuiBalance,
+        staking_pool_sui_balance_sui: toSui(v.stakingPoolSuiBalance),
+        next_epoch_stake_mist: v.nextEpochStake,
+        voting_power: Number(v.votingPower),
+        apy,
+        apy_percent: apy !== null ? Number((apy * 100).toFixed(4)) : null,
+        note: 'apy is a fraction (0.041 = 4.1%); commission_rate_bps is basis points (10000 = 100%).',
+    });
+}
+//# sourceMappingURL=sui_get_validator.js.map

package/dist/tools/sui_get_validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_validator.js","sourceRoot":"","sources":["../../src/tools/sui_get_validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D,MAAM,KAAK,GAAG,CAAC,IAA8B,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAY;IAChD,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtC,MAAM,CAAC,uBAAuB,EAAE;QAChC,MAAM,CAAC,gBAAgB,EAAE;KAC1B,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,iBAAiB,CAAC,CAAC;IACjF,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,aAAa,iBAAiB,6BAA6B,OAAO,WAAW,KAAK,CAAC,KAAK,oCAAoC,CAC7H,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,iBAAiB,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC;IAEhC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,iBAAiB,EAAE,CAAC,CAAC,UAAU;QAC/B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,SAAS,EAAE,CAAC,CAAC,QAAQ;QACrB,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;QAC7C,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,GAAG;QAClD,eAAe,EAAE,CAAC,CAAC,aAAa;QAChC,6BAA6B,EAAE,CAAC,CAAC,qBAAqB;QACtD,4BAA4B,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAC5D,qBAAqB,EAAE,CAAC,CAAC,cAAc;QACvC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;QACnC,GAAG;QACH,WAAW,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACjE,IAAI,EAAE,uFAAuF;KAC9F,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_get_validators.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The active validator set plus epoch context, from the Sui system state.
+ * Read-only. Gives a staking app the human-readable name, the staking
+ * address to pass to sui_stake, the commission rate (validators keep a cut
+ * of rewards), and the total stake behind each validator. Combine with
+ * sui_get_validators_apy (matched on validator_address) to render a full
+ * "pick a validator" table: name + APY + commission + size.
+ */
+export declare function suiGetValidators(raw: unknown): Promise<string>;

package/dist/tools/sui_get_validators.js

@@ -0,0 +1,46 @@
+import { clientFor } from '../sui-client.js';
+const toSui = (mist) => Number(BigInt(mist)) / 1e9;
+/**
+ * The active validator set plus epoch context, from the Sui system state.
+ * Read-only. Gives a staking app the human-readable name, the staking
+ * address to pass to sui_stake, the commission rate (validators keep a cut
+ * of rewards), and the total stake behind each validator. Combine with
+ * sui_get_validators_apy (matched on validator_address) to render a full
+ * "pick a validator" table: name + APY + commission + size.
+ */
+export async function suiGetValidators(raw) {
+    const { network, limit } = raw;
+    const client = clientFor(network);
+    const state = await client.getLatestSuiSystemState();
+    let validators = state.activeValidators.map((v) => ({
+        name: v.name,
+        validator_address: v.suiAddress,
+        description: v.description,
+        image_url: v.imageUrl,
+        project_url: v.projectUrl,
+        commission_rate_bps: Number(v.commissionRate),
+        commission_percent: Number(v.commissionRate) / 100,
+        staking_pool_sui_balance_mist: v.stakingPoolSuiBalance,
+        staking_pool_sui_balance_sui: toSui(v.stakingPoolSuiBalance),
+        next_epoch_stake_mist: v.nextEpochStake,
+        voting_power: Number(v.votingPower),
+    }));
+    // Largest first — a reasonable default for a validator picker.
+    validators.sort((a, b) => Number(BigInt(b.staking_pool_sui_balance_mist) - BigInt(a.staking_pool_sui_balance_mist)));
+    if (typeof limit === 'number') {
+        validators = validators.slice(0, limit);
+    }
+    return JSON.stringify({
+        network,
+        epoch: state.epoch,
+        protocol_version: state.protocolVersion,
+        epoch_start_timestamp_ms: state.epochStartTimestampMs,
+        epoch_duration_ms: state.epochDurationMs,
+        total_stake_mist: state.totalStake,
+        total_stake_sui: toSui(state.totalStake),
+        active_validator_count: state.activeValidators.length,
+        validators,
+        note: 'commission_rate_bps is in basis points (10000 = 100%). validator_address is what sui_stake expects. Match validator_address against sui_get_validators_apy for APY.',
+    });
+}
+//# sourceMappingURL=sui_get_validators.js.map

package/dist/tools/sui_get_validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_get_validators.js","sourceRoot":"","sources":["../../src/tools/sui_get_validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D,MAAM,KAAK,GAAG,CAAC,IAA8B,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAY;IACjD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAW,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAErD,IAAI,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,iBAAiB,EAAE,CAAC,CAAC,UAAU;QAC/B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,SAAS,EAAE,CAAC,CAAC,QAAQ;QACrB,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;QAC7C,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,GAAG;QAClD,6BAA6B,EAAE,CAAC,CAAC,qBAAqB;QACtD,4BAA4B,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAC5D,qBAAqB,EAAE,CAAC,CAAC,cAAc;QACvC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;KACpC,CAAC,CAAC,CAAC;IAEJ,+DAA+D;IAC/D,UAAU,CAAC,IAAI,CACb,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAC5F,CAAC;IACF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,gBAAgB,EAAE,KAAK,CAAC,eAAe;QACvC,wBAAwB,EAAE,KAAK,CAAC,qBAAqB;QACrD,iBAAiB,EAAE,KAAK,CAAC,eAAe;QACxC,gBAAgB,EAAE,KAAK,CAAC,UAAU;QAClC,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QACxC,sBAAsB,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM;QACrD,UAAU;QACV,IAAI,EAAE,qKAAqK;KAC5K,CAAC,CAAC;AACL,CAAC"}