bostrom-mcp 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,218 @@
+# bostrom-mcp
+
+[MCP](https://modelcontextprotocol.io) server for the [Bostrom](https://cyb.ai) blockchain — knowledge graph, economy, lithium mining, governance, infrastructure, and **autonomous agent capabilities**.
+
+87 tools: 44 read + 43 write. Read tools work with zero configuration. Write tools require a wallet mnemonic.
+
+## Quick start
+
+```jsonc
+// Claude Desktop / Cursor / any MCP client
+{
+  "mcpServers": {
+    "bostrom": {
+      "command": "npx",
+      "args": ["-y", "bostrom-mcp"],
+      "env": {
+        "BOSTROM_MNEMONIC": "your twelve word mnemonic phrase here ..."
+      }
+    }
+  }
+}
+```
+
+Read-only mode (no mnemonic needed):
+
+```bash
+npx -y bostrom-mcp
+```
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `BOSTROM_MNEMONIC` | — | Wallet mnemonic for write tools. Without it, only read tools are available. |
+| `BOSTROM_RPC` | `https://rpc.bostrom.cybernode.ai` | RPC endpoint |
+| `BOSTROM_LCD` | `https://lcd.bostrom.cybernode.ai` | LCD/REST endpoint |
+| `BOSTROM_IPFS_API` | `https://io.cybernode.ai` | IPFS API for pinning content |
+| `BOSTROM_GAS_PRICE` | `0.01boot` | Gas price |
+| `BOSTROM_GAS_MULTIPLIER` | `1.4` | Gas estimate multiplier |
+| `BOSTROM_MIN_GAS` | `100000` | Minimum gas limit |
+| `BOSTROM_MAX_SEND_AMOUNT` | — | Circuit breaker: max amount per send (optional) |
+
+## Tools
+
+### Knowledge Graph — Read (6)
+
+| Tool | Description |
+|------|-------------|
+| `graph_search` | Search cyberlinks by particle CID or neuron address |
+| `graph_rank` | Get cyberank score for a particle |
+| `graph_neuron` | Get neuron profile and cyberlink count |
+| `graph_particle` | Fetch particle content by CID from IPFS |
+| `graph_recent_links` | Get the most recent cyberlinks |
+| `graph_stats` | Total cyberlinks and active neurons |
+
+### Knowledge Graph — Write (5)
+
+| Tool | Description |
+|------|-------------|
+| `graph_create_cyberlink` | Create a single cyberlink between two CIDs |
+| `graph_create_cyberlinks` | Create multiple cyberlinks in one transaction |
+| `graph_investmint` | Convert HYDROGEN into millivolt or milliampere |
+| `graph_pin_content` | Pin text content to IPFS and return the CID |
+| `graph_create_knowledge` | Compound: pin content to IPFS then create cyberlinks |
+
+### Economy (6)
+
+| Tool | Description |
+|------|-------------|
+| `economy_balances` | All token balances for an address |
+| `economy_supply` | Total supply for a token denom |
+| `economy_mint_price` | Current Volt and Ampere mint prices |
+| `economy_staking` | Delegations, rewards, and unbonding for an address |
+| `economy_pools` | Liquidity pool stats |
+| `economy_inflation` | Current inflation rate and minting parameters |
+
+### Wallet (7)
+
+| Tool | Description |
+|------|-------------|
+| `wallet_info` | Get wallet address and all balances |
+| `wallet_send` | Send tokens to an address |
+| `wallet_delegate` | Delegate tokens to a validator |
+| `wallet_undelegate` | Undelegate tokens from a validator |
+| `wallet_redelegate` | Move delegation between validators |
+| `wallet_claim_rewards` | Claim staking rewards from a validator |
+| `wallet_vote` | Vote on a governance proposal |
+
+### Token Factory (6)
+
+| Tool | Description |
+|------|-------------|
+| `token_create` | Create a new token denom (costs ~10,000 BOOT) |
+| `token_set_metadata` | Set token name, symbol, description, exponent |
+| `token_mint` | Mint tokens to an address |
+| `token_burn` | Burn tokens from an address |
+| `token_change_admin` | Transfer token admin to another address |
+| `token_list_created` | List all denoms created by this wallet |
+
+### Liquidity & Swap (7)
+
+| Tool | Description |
+|------|-------------|
+| `swap_tokens` | Swap tokens with auto pool discovery and price calculation |
+| `swap_estimate` | Preview a swap: find pool, get price, estimate output |
+| `liquidity_create_pool` | Create a Gravity DEX pool (costs ~1,000 BOOT) |
+| `liquidity_deposit` | Deposit tokens into a pool |
+| `liquidity_withdraw` | Withdraw LP tokens from a pool |
+| `liquidity_swap` | Swap via pool with explicit pool ID and limit price |
+| `liquidity_pool_detail` | Get pool reserves, parameters, and batch info |
+
+### CosmWasm Contracts (7)
+
+| Tool | Description |
+|------|-------------|
+| `contract_execute` | Execute a contract message |
+| `contract_execute_multi` | Execute multiple contract messages atomically |
+| `wasm_upload` | Upload .wasm bytecode to chain |
+| `wasm_instantiate` | Instantiate a contract from code ID |
+| `wasm_migrate` | Migrate a contract to new code |
+| `wasm_update_admin` | Update contract admin |
+| `wasm_clear_admin` | Clear contract admin (irreversible) |
+
+### Lithium Mining — Read (25)
+
+| Tool | Description |
+|------|-------------|
+| `li_core_config` | Token denom, admin, paused status |
+| `li_burn_stats` | Total LI burned |
+| `li_total_minted` | Total LI minted and supply cap |
+| `li_mine_state` | Full mine state: config, seed, difficulty, stats, epoch, proofs, emission |
+| `li_mine_config` | Difficulty, base reward, period duration, target proofs |
+| `li_seed` | Current mining seed and interval |
+| `li_difficulty` | Current difficulty, min profitable, window proof count |
+| `li_epoch_status` | Current epoch: start/end blocks, proof count, target solutions |
+| `li_proof_stats` | Epoch proof counters and total work |
+| `li_emission` | Emission breakdown: mining, staking, referral |
+| `li_reward_estimate` | Estimate LI reward for a given difficulty |
+| `li_mine_stats` | Aggregate: total proofs, rewards, unique miners |
+| `li_miner_stats` | Per-miner: proofs submitted, total rewards, last proof height |
+| `li_miner_epoch_stats` | Miner's proof count for a specific epoch |
+| `li_verify_proof` | Dry-run verify a proof without submitting |
+| `li_recent_proofs` | Recent proof submission transactions |
+| `li_stake_config` | Unbonding period, linked contracts |
+| `li_total_staked` | Total LI staked across all stakers |
+| `li_stake_info` | Staking state for an address |
+| `li_staking_stats` | Reserve, total staked, reward index |
+| `li_refer_config` | Referral contract config |
+| `li_referrer_of` | Who referred a specific miner |
+| `li_referral_info` | Referral rewards and count for a referrer |
+| `li_community_pool` | Unclaimed community pool balance |
+| `li_miner_tx_history` | Miner's recent contract TX history |
+
+### Lithium Mining — Write (5)
+
+| Tool | Description |
+|------|-------------|
+| `li_submit_proof` | Submit a mining proof |
+| `li_stake` | Stake LI tokens |
+| `li_unstake` | Unstake LI tokens |
+| `li_claim_rewards` | Claim LI staking rewards |
+| `li_set_referrer` | Set referrer for your address |
+
+### Energy Grid (4)
+
+| Tool | Description |
+|------|-------------|
+| `grid_create_route` | Create an energy route to another address |
+| `grid_edit_route` | Edit route allocated value (millivolt/milliampere) |
+| `grid_delete_route` | Delete an energy route |
+| `grid_list_routes` | List all routes from an address |
+
+### Governance (4)
+
+| Tool | Description |
+|------|-------------|
+| `gov_proposals` | List proposals (active, passed, rejected, all) |
+| `gov_proposal_detail` | Full proposal details with vote tally |
+| `gov_validators` | Active validator set with commission and voting power |
+| `gov_params` | Chain parameters |
+
+### IBC (2)
+
+| Tool | Description |
+|------|-------------|
+| `ibc_transfer` | IBC token transfer to another chain |
+| `ibc_channels` | List IBC channels and their status |
+
+### Infrastructure (3)
+
+| Tool | Description |
+|------|-------------|
+| `infra_chain_status` | Latest block height, time, chain ID, sync status |
+| `infra_tx_search` | Search transactions by sender, contract, or message type |
+| `infra_tx_detail` | Full decoded transaction by hash |
+
+## Agent workflows
+
+With write tools enabled, an LLM agent can perform autonomous workflows:
+
+- **Lithium mining**: `li_mine_state` → compute proof → `li_verify_proof` → `li_submit_proof` → `li_stake`
+- **Token launch + market**: `token_create` → `token_set_metadata` → `token_mint` → `liquidity_create_pool` → `graph_create_knowledge`
+- **Knowledge graph**: `graph_pin_content` → `graph_create_cyberlink` → `graph_search` → `graph_rank`
+- **Governance**: `gov_proposals` → `gov_proposal_detail` → `wallet_vote`
+- **DeFi**: `swap_estimate` → `swap_tokens` → `liquidity_deposit`
+- **Contract deployment**: `wasm_upload` → `wasm_instantiate` → `contract_execute`
+
+## Development
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+## License
+
+MIT

package/dist/clients/ipfs-write.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pin content to IPFS and return the CID.
+ * Supports both kubo API (/api/v0/add) and IPFS Cluster API (/add).
+ * Default: https://io.cybernode.ai (cybernode IPFS cluster).
+ */
+export declare function ipfsAdd(content: string): Promise<string>;

package/dist/clients/ipfs-write.js

@@ -0,0 +1,31 @@
+const IPFS_API = process.env.BOSTROM_IPFS_API ?? "https://io.cybernode.ai";
+/**
+ * Pin content to IPFS and return the CID.
+ * Supports both kubo API (/api/v0/add) and IPFS Cluster API (/add).
+ * Default: https://io.cybernode.ai (cybernode IPFS cluster).
+ */
+export async function ipfsAdd(content) {
+    const formData = new FormData();
+    formData.append("file", new Blob([content], { type: "text/plain" }));
+    // Detect endpoint type: cluster uses /add, kubo uses /api/v0/add
+    const isCluster = !IPFS_API.includes("5001") && !IPFS_API.includes("localhost") && !IPFS_API.includes("127.0.0.1");
+    const url = isCluster
+        ? `${IPFS_API}/add?cid-version=0&raw-leaves=false`
+        : `${IPFS_API}/api/v0/add?pin=true`;
+    const res = await fetch(url, {
+        method: "POST",
+        body: formData,
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!res.ok) {
+        throw new Error(`IPFS add failed (${res.status}): ${res.statusText}`);
+    }
+    const data = await res.json();
+    // Cluster returns { cid }, kubo returns { Hash }
+    const cid = data.cid ?? data.Hash;
+    if (!cid) {
+        throw new Error(`IPFS add: no CID in response: ${JSON.stringify(data)}`);
+    }
+    return cid;
+}
+//# sourceMappingURL=ipfs-write.js.map

package/dist/clients/ipfs-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-write.js","sourceRoot":"","sources":["../../src/clients/ipfs-write.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;AAK3E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAErE,iEAAiE;IACjE,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnH,MAAM,GAAG,GAAG,SAAS;QACnB,CAAC,CAAC,GAAG,QAAQ,qCAAqC;QAClD,CAAC,CAAC,GAAG,QAAQ,sBAAsB,CAAC;IAEtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,iDAAiD;IACjD,MAAM,GAAG,GAAI,IAA2B,CAAC,GAAG,IAAK,IAAwB,CAAC,IAAI,CAAC;IAC/E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/clients/signing.d.ts

@@ -0,0 +1,27 @@
+import { SigningStargateClient, type DeliverTxResponse } from "@cosmjs/stargate";
+import { SigningCosmWasmClient } from "@cosmjs/cosmwasm-stargate";
+import type { EncodeObject } from "@cosmjs/proto-signing";
+/** Get the wallet address (initializes wallet on first call) */
+export declare function getWalletAddress(): Promise<string>;
+/**
+ * Get a SigningStargateClient with cyber + osmosis + default types registered.
+ * Used for chain-native messages (bank, staking, gov, cyberlink, tokenfactory, etc.)
+ */
+export declare function getStargateClient(): Promise<SigningStargateClient>;
+/**
+ * Get a SigningCosmWasmClient for contract execution.
+ * Includes wasm types (MsgExecuteContract, etc.) automatically.
+ */
+export declare function getCosmWasmClient(): Promise<SigningCosmWasmClient>;
+/** Sign and broadcast messages using the stargate client with auto gas */
+export declare function signAndBroadcast(msgs: EncodeObject[], memo?: string): Promise<DeliverTxResponse>;
+/** Format a DeliverTxResponse for tool output */
+export declare function formatTxResult(result: DeliverTxResponse): {
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    code: number;
+};
+/** Check amount against BOSTROM_MAX_SEND_AMOUNT circuit breaker */
+export declare function checkAmountLimit(amount: string, denom: string): void;

package/dist/clients/signing.js

@@ -0,0 +1,116 @@
+import { createRequire } from "node:module";
+import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
+import { SigningStargateClient, defaultRegistryTypes, GasPrice, } from "@cosmjs/stargate";
+import { SigningCosmWasmClient } from "@cosmjs/cosmwasm-stargate";
+import { Registry } from "@cosmjs/proto-signing";
+// CJS sub-path imports — cyber-ts lacks ESM "exports" field
+const require = createRequire(import.meta.url);
+const { cyberProtoRegistry } = require("@cybercongress/cyber-ts/cyber/client");
+const { osmosisProtoRegistry } = require("@cybercongress/cyber-ts/osmosis/client");
+const RPC_ENDPOINT = process.env.BOSTROM_RPC ?? "https://rpc.bostrom.cybernode.ai";
+const ADDRESS_PREFIX = "bostrom";
+const GAS_PRICE_STR = process.env.BOSTROM_GAS_PRICE ?? "0.01boot";
+const GAS_MULTIPLIER = Number(process.env.BOSTROM_GAS_MULTIPLIER ?? "1.4");
+let wallet = null;
+let address = null;
+let stargateClient = null;
+let cosmwasmClient = null;
+function requireMnemonic() {
+    const mnemonic = process.env.BOSTROM_MNEMONIC;
+    if (!mnemonic) {
+        throw new Error("BOSTROM_MNEMONIC environment variable is not set. " +
+            "Write tools require a wallet. Set BOSTROM_MNEMONIC to enable signing.");
+    }
+    return mnemonic;
+}
+async function initWallet() {
+    if (wallet)
+        return;
+    const mnemonic = requireMnemonic();
+    wallet = await DirectSecp256k1HdWallet.fromMnemonic(mnemonic, {
+        prefix: ADDRESS_PREFIX,
+    });
+    const [account] = await wallet.getAccounts();
+    address = account.address;
+}
+/** Get the wallet address (initializes wallet on first call) */
+export async function getWalletAddress() {
+    await initWallet();
+    return address;
+}
+/** Build a merged registry: default stargate + cyber + osmosis types */
+function buildRegistry() {
+    return new Registry([
+        ...defaultRegistryTypes,
+        ...cyberProtoRegistry,
+        ...osmosisProtoRegistry,
+    ]);
+}
+/**
+ * Get a SigningStargateClient with cyber + osmosis + default types registered.
+ * Used for chain-native messages (bank, staking, gov, cyberlink, tokenfactory, etc.)
+ */
+export async function getStargateClient() {
+    await initWallet();
+    if (!stargateClient) {
+        const registry = buildRegistry();
+        stargateClient = await SigningStargateClient.connectWithSigner(RPC_ENDPOINT, wallet, {
+            registry,
+            gasPrice: GasPrice.fromString(GAS_PRICE_STR),
+        });
+    }
+    return stargateClient;
+}
+/**
+ * Get a SigningCosmWasmClient for contract execution.
+ * Includes wasm types (MsgExecuteContract, etc.) automatically.
+ */
+export async function getCosmWasmClient() {
+    await initWallet();
+    if (!cosmwasmClient) {
+        cosmwasmClient = await SigningCosmWasmClient.connectWithSigner(RPC_ENDPOINT, wallet, {
+            gasPrice: GasPrice.fromString(GAS_PRICE_STR),
+        });
+    }
+    return cosmwasmClient;
+}
+const MIN_GAS = Number(process.env.BOSTROM_MIN_GAS ?? "100000");
+/** Sign and broadcast messages using the stargate client with auto gas */
+export async function signAndBroadcast(msgs, memo) {
+    const client = await getStargateClient();
+    const addr = await getWalletAddress();
+    const gasEstimate = await client.simulate(addr, msgs, memo);
+    const gasLimit = Math.max(Math.ceil(gasEstimate * GAS_MULTIPLIER), MIN_GAS);
+    const fee = {
+        amount: [{ denom: "boot", amount: String(Math.ceil(gasLimit * 0.01)) }],
+        gas: String(gasLimit),
+    };
+    const result = await client.signAndBroadcast(addr, msgs, fee, memo);
+    if (result.code !== 0) {
+        throw new Error(`Transaction failed (code ${result.code}): ${result.rawLog}`);
+    }
+    return result;
+}
+/** Format a DeliverTxResponse for tool output */
+export function formatTxResult(result) {
+    return {
+        txHash: result.transactionHash,
+        height: result.height,
+        gasUsed: result.gasUsed,
+        gasWanted: result.gasWanted,
+        code: result.code,
+    };
+}
+/** Check amount against BOSTROM_MAX_SEND_AMOUNT circuit breaker */
+export function checkAmountLimit(amount, denom) {
+    const maxStr = process.env.BOSTROM_MAX_SEND_AMOUNT;
+    if (!maxStr)
+        return;
+    const max = BigInt(maxStr);
+    const val = BigInt(amount);
+    if (val > max) {
+        throw new Error(`Amount ${amount} ${denom} exceeds BOSTROM_MAX_SEND_AMOUNT (${maxStr}). ` +
+            "Increase the limit or reduce the amount.");
+    }
+}
+//# sourceMappingURL=signing.js.map

package/dist/clients/signing.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+export declare const createSandboxServer: typeof createServer;

package/dist/index.js

@@ -1,26 +1,52 @@
 #!/usr/bin/env node
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+// Read tools
 import { registerGraphTools } from "./tools/graph.js";
 import { registerEconomyTools } from "./tools/economy.js";
 import { registerLithiumTools } from "./tools/lithium.js";
 import { registerGovernanceTools } from "./tools/governance.js";
 import { registerInfraTools } from "./tools/infra.js";
-const server = new McpServer({
-    name: "bostrom",
-    version: "0.1.0",
-});
-registerGraphTools(server);
-registerEconomyTools(server);
-registerLithiumTools(server);
-registerGovernanceTools(server);
-registerInfraTools(server);
-async function main() {
+// Write tools
+import { registerWalletTools } from "./tools/wallet.js";
+import { registerGraphWriteTools } from "./tools/graph-write.js";
+import { registerContractTools } from "./tools/contract.js";
+import { registerLithiumWriteTools } from "./tools/lithium-write.js";
+import { registerTokenFactoryTools } from "./tools/tokenfactory.js";
+import { registerLiquidityTools } from "./tools/liquidity.js";
+import { registerGridTools } from "./tools/grid.js";
+import { registerIbcTools } from "./tools/ibc.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "bostrom",
+        version: "0.2.0",
+    });
+    // Read tools (44)
+    registerGraphTools(server);
+    registerEconomyTools(server);
+    registerLithiumTools(server);
+    registerGovernanceTools(server);
+    registerInfraTools(server);
+    // Write tools (43)
+    registerWalletTools(server);
+    registerGraphWriteTools(server);
+    registerContractTools(server);
+    registerLithiumWriteTools(server);
+    registerTokenFactoryTools(server);
+    registerLiquidityTools(server);
+    registerGridTools(server);
+    registerIbcTools(server);
+    return server;
+}
+export const createSandboxServer = createServer;
+const isDirectRun = import.meta.url && process.argv[1] === fileURLToPath(import.meta.url);
+if (isDirectRun) {
+    const server = createServer();
     const transport = new StdioServerTransport();
-    await server.connect(transport);
+    server.connect(transport).catch((err) => {
+        console.error("Fatal:", err);
+        process.exit(1);
+    });
 }
-main().catch((err) => {
-    console.error("Fatal:", err);
-    process.exit(1);
-});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,cAAc;AACd,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,kBAAkB;IAClB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,mBAAmB;IACnB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,MAAM,WAAW,GACf,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAExE,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/contract-exec.d.ts

@@ -0,0 +1,84 @@
+import type { Coin } from "@cosmjs/amino";
+/** Execute a single CosmWasm contract message */
+export declare function executeContract(contractAddr: string, msg: Record<string, unknown>, funds?: Coin[], memo?: string): Promise<{
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    sender: string;
+    contract: string;
+}>;
+/** Upload wasm bytecode. Returns code ID. */
+export declare function uploadCode(wasmBytecode: Uint8Array, memo?: string): Promise<{
+    codeId: number;
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    checksum: string;
+    sender: string;
+}>;
+/** Upload wasm bytecode from a file path. Returns code ID. */
+export declare function uploadCodeFromFile(filePath: string, memo?: string): Promise<{
+    codeId: number;
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    checksum: string;
+    sender: string;
+}>;
+/** Instantiate a contract from a code ID */
+export declare function instantiateContract(codeId: number, msg: Record<string, unknown>, label: string, funds?: Coin[], admin?: string, memo?: string): Promise<{
+    contractAddress: string;
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    codeId: number;
+    label: string;
+    sender: string;
+}>;
+/** Migrate a contract to a new code ID */
+export declare function migrateContract(contractAddr: string, newCodeId: number, msg: Record<string, unknown>, memo?: string): Promise<{
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    sender: string;
+    contract: string;
+    newCodeId: number;
+}>;
+/** Update the admin of a contract */
+export declare function updateContractAdmin(contractAddr: string, newAdmin: string, memo?: string): Promise<{
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    sender: string;
+    contract: string;
+    newAdmin: string;
+}>;
+/** Clear the admin of a contract (makes it immutable) */
+export declare function clearContractAdmin(contractAddr: string, memo?: string): Promise<{
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    sender: string;
+    contract: string;
+    note: string;
+}>;
+/** Execute multiple contract messages in a single transaction */
+export declare function executeContractMulti(operations: Array<{
+    contract: string;
+    msg: Record<string, unknown>;
+    funds?: Coin[];
+}>, memo?: string): Promise<{
+    txHash: string;
+    height: number;
+    gasUsed: bigint;
+    gasWanted: bigint;
+    sender: string;
+    operationCount: number;
+}>;