dappily-agent-kit 0.1.0

package/dist/actions/burn_token.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const burnTokenAction = {
+    name: "BURN_TOKEN",
+    similes: [
+        "burn token",
+        "burn tokens",
+        "decrease supply",
+        "destroy tokens",
+        "reduce supply",
+    ],
+    description: "Burn fungible tokens, permanently reducing the total supply. The tokens are burned from the treasury account. The token must have been created with a supply key. By default, the agent's operator key is used to sign.",
+    examples: [
+        [
+            {
+                input: {
+                    tokenId: "0.0.99999",
+                    amount: 1000,
+                },
+                output: {
+                    ok: true,
+                    summary: "Burned 1,000 of token 0.0.99999",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        tokenId: "0.0.99999",
+                        amountBurned: 1000,
+                        newTotalSupply: "9000",
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Burn 1,000 tokens from the treasury supply",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        tokenId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Token ID format (must be 0.0.X)")
+            .describe("The token ID to burn (e.g. 0.0.99999)"),
+        amount: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .describe("Amount of tokens to burn (in smallest unit)"),
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Optional memo for the transaction"),
+        supplyPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Supply key for the token (only needed if different from operator key)"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (agent, input) => {
+        const warnings = [];
+        if (input.amount >= 1000000) {
+            warnings.push(`Large burn: ${input.amount.toLocaleString()} units. This is permanent and irreversible.`);
+        }
+        // Always warn — burns are destructive
+        warnings.push("⚠️ Token burns are irreversible. Supply cannot be recovered.");
+        return {
+            summary: `Burn ${input.amount.toLocaleString()} of token ${input.tokenId}`,
+            estimatedFeeHbar: 0.001,
+            warnings,
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const tx = new sdk_1.TokenBurnTransaction()
+                .setTokenId(input.tokenId)
+                .setAmount(input.amount);
+            if (input.memo) {
+                tx.setTransactionMemo(input.memo);
+            }
+            // Freeze before signing
+            const frozenTx = await tx.freezeWith(agent.client);
+            // Sign with custom supply key if provided
+            if (input.supplyPrivateKey) {
+                const supplyKey = sdk_1.PrivateKey.fromString(input.supplyPrivateKey);
+                await frozenTx.sign(supplyKey);
+            }
+            const response = await frozenTx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                const statusStr = receipt.status.toString();
+                if (statusStr.includes("INSUFFICIENT_TOKEN_BALANCE")) {
+                    return {
+                        ok: false,
+                        error: "INSUFFICIENT_TOKEN_BALANCE",
+                        details: `Cannot burn ${input.amount.toLocaleString()} tokens — the treasury does not hold enough. Check the current supply.`,
+                    };
+                }
+                return {
+                    ok: false,
+                    error: statusStr,
+                    details: `Burn failed with status: ${statusStr}`,
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Burned ${input.amount.toLocaleString()} of token ${input.tokenId}`,
+                txId,
+                receipt: {
+                    status: receipt.status.toString(),
+                },
+                data: {
+                    tokenId: input.tokenId,
+                    amountBurned: input.amount,
+                    newTotalSupply: receipt.totalSupply?.toString() ?? "unknown",
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Catch insufficient balance at SDK level too
+            if (message.includes("INSUFFICIENT_TOKEN_BALANCE")) {
+                return {
+                    ok: false,
+                    error: "INSUFFICIENT_TOKEN_BALANCE",
+                    details: `Cannot burn ${input.amount.toLocaleString()} tokens — the treasury does not hold enough.`,
+                };
+            }
+            const knownErrors = {
+                TOKEN_HAS_NO_SUPPLY_KEY: "This token was created without a supply key. Burning is permanently disabled.",
+                INVALID_SIGNATURE: "Transaction signature is invalid. The supply key doesn't match.",
+                INVALID_TOKEN_ID: "The token ID does not exist on this network.",
+                TOKEN_WAS_DELETED: "This token has been deleted.",
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the transaction fee.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "BURN_TOKEN_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = burnTokenAction;
+//# sourceMappingURL=burn_token.js.map

package/dist/actions/burn_token.js.map

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

package/dist/actions/create_nft_collection.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const createNftCollectionAction: Action;
+export default createNftCollectionAction;
+//# sourceMappingURL=create_nft_collection.d.ts.map

package/dist/actions/create_nft_collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_nft_collection.d.ts","sourceRoot":"","sources":["../../src/actions/create_nft_collection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AASvD,QAAA,MAAM,yBAAyB,EAAE,MA2LhC,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/actions/create_nft_collection.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const createNftCollectionAction = {
+    name: "CREATE_NFT_COLLECTION",
+    similes: [
+        "create nft collection",
+        "create nft",
+        "launch nft",
+        "deploy nft",
+        "new nft collection",
+        "nft collection",
+        "make nft",
+    ],
+    description: "Create a new NFT collection (NonFungibleUnique token) on the Hedera Token Service. The operator key is used as admin and supply key by default. Max supply can optionally be capped.",
+    examples: [
+        [
+            {
+                input: {
+                    name: "Dappily Genesis",
+                    symbol: "DGEN",
+                    memo: "The first Dappily NFT collection",
+                },
+                output: {
+                    ok: true,
+                    summary: "Created NFT collection DGEN (0.0.88888)",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        tokenId: "0.0.88888",
+                        name: "Dappily Genesis",
+                        symbol: "DGEN",
+                        type: "NON_FUNGIBLE_UNIQUE",
+                        treasury: "0.0.12345",
+                        maxSupply: "unlimited",
+                        hasAdminKey: true,
+                        hasSupplyKey: true,
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Create an NFT collection with unlimited supply",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        name: zod_1.z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("The human-readable name of the NFT collection"),
+        symbol: zod_1.z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("The ticker symbol for the collection (e.g. 'DGEN')"),
+        maxSupply: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Optional max supply cap. Omit for unlimited."),
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Optional memo attached to the collection"),
+        adminPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Admin key (only if different from operator key)"),
+        supplyPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Supply key (only if different from operator key)"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (_agent, input) => {
+        return {
+            summary: `Create NFT collection "${input.name}" (${input.symbol})${input.maxSupply ? `, max supply: ${input.maxSupply}` : ", unlimited supply"}`,
+            estimatedFeeHbar: 1,
+            warnings: [],
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const adminKey = input.adminPrivateKey
+                ? sdk_1.PrivateKey.fromString(input.adminPrivateKey).publicKey
+                : agent.privateKey.publicKey;
+            const supplyKey = input.supplyPrivateKey
+                ? sdk_1.PrivateKey.fromString(input.supplyPrivateKey).publicKey
+                : agent.privateKey.publicKey;
+            const tx = new sdk_1.TokenCreateTransaction()
+                .setTokenName(input.name)
+                .setTokenSymbol(input.symbol)
+                .setTokenType(sdk_1.TokenType.NonFungibleUnique)
+                .setDecimals(0)
+                .setInitialSupply(0)
+                .setTreasuryAccountId(agent.accountId)
+                .setAdminKey(adminKey)
+                .setSupplyKey(supplyKey);
+            if (input.maxSupply) {
+                tx.setSupplyType(sdk_1.TokenSupplyType.Finite);
+                tx.setMaxSupply(input.maxSupply);
+            }
+            else {
+                tx.setSupplyType(sdk_1.TokenSupplyType.Infinite);
+            }
+            if (input.memo) {
+                tx.setTokenMemo(input.memo);
+            }
+            // Freeze, sign with custom keys if needed, execute
+            const frozenTx = await tx.freezeWith(agent.client);
+            if (input.adminPrivateKey) {
+                await frozenTx.sign(sdk_1.PrivateKey.fromString(input.adminPrivateKey));
+            }
+            if (input.supplyPrivateKey && input.supplyPrivateKey !== input.adminPrivateKey) {
+                await frozenTx.sign(sdk_1.PrivateKey.fromString(input.supplyPrivateKey));
+            }
+            const response = await frozenTx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                return {
+                    ok: false,
+                    error: receipt.status.toString(),
+                    details: `NFT collection creation failed with status: ${receipt.status.toString()}`,
+                };
+            }
+            const tokenId = receipt.tokenId;
+            if (!tokenId) {
+                return {
+                    ok: false,
+                    error: "NO_TOKEN_ID",
+                    details: "Transaction succeeded but no token ID was returned.",
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Created NFT collection ${input.symbol} (${tokenId.toString()})`,
+                txId,
+                receipt: { status: receipt.status.toString() },
+                data: {
+                    tokenId: tokenId.toString(),
+                    name: input.name,
+                    symbol: input.symbol,
+                    type: "NON_FUNGIBLE_UNIQUE",
+                    treasury: agent.accountId.toString(),
+                    maxSupply: input.maxSupply?.toString() ?? "unlimited",
+                    hasAdminKey: true,
+                    hasSupplyKey: true,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const knownErrors = {
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the NFT collection creation fee (~1 HBAR).",
+                INVALID_TOKEN_SYMBOL: "Token symbol is invalid.",
+                INVALID_TOKEN_NAME: "Token name is invalid.",
+                INVALID_SIGNATURE: "Transaction signature is invalid. Check your keys.",
+                INVALID_ACCOUNT_ID: "The account ID does not exist on this network.",
+                TOKEN_WAS_DELETED: "This token has been deleted.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "CREATE_NFT_COLLECTION_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = createNftCollectionAction;
+//# sourceMappingURL=create_nft_collection.js.map

package/dist/actions/create_nft_collection.js.map

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

package/dist/actions/create_token.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const createTokenAction: Action;
+export default createTokenAction;
+//# sourceMappingURL=create_token.d.ts.map

package/dist/actions/create_token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_token.d.ts","sourceRoot":"","sources":["../../src/actions/create_token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAQvD,QAAA,MAAM,iBAAiB,EAAE,MAuKxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/actions/create_token.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const createTokenAction = {
+    name: "CREATE_TOKEN",
+    similes: [
+        "create token",
+        "launch token",
+        "deploy token",
+        "make token",
+        "new token",
+        "mint token",
+        "token factory",
+    ],
+    description: "Create a new fungible token on the Hedera Token Service (HTS). The agent's operator account is used as the treasury by default. The operator key is set as both admin key and supply key, enabling future mint/burn operations.",
+    examples: [
+        [
+            {
+                input: {
+                    name: "Dappily Coin",
+                    symbol: "DAPP",
+                    initialSupply: 1000000,
+                    decimals: 2,
+                    memo: "The Dappily utility token",
+                },
+                output: {
+                    ok: true,
+                    summary: "Created token DAPP (0.0.99999) with initial supply 1,000,000",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        tokenId: "0.0.99999",
+                        name: "Dappily Coin",
+                        symbol: "DAPP",
+                        decimals: 2,
+                        initialSupply: 1000000,
+                        treasury: "0.0.12345",
+                        hasAdminKey: true,
+                        hasSupplyKey: true,
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Create a fungible token with 2 decimal places and 1M initial supply",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        name: zod_1.z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("The human-readable name of the token (e.g. 'Dappily Coin')"),
+        symbol: zod_1.z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("The ticker symbol for the token (e.g. 'DAPP')"),
+        decimals: zod_1.z
+            .number()
+            .int()
+            .min(0)
+            .max(18)
+            .optional()
+            .default(0)
+            .describe("Number of decimal places (default 0, max 18)"),
+        initialSupply: zod_1.z
+            .number()
+            .int()
+            .min(0)
+            .describe("Initial supply of the token (in the smallest unit)"),
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Optional memo attached to the token"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (agent, input) => {
+        return {
+            summary: `Create token "${input.name}" (${input.symbol}) with supply ${input.initialSupply.toLocaleString()} and ${input.decimals ?? 0} decimals`,
+            estimatedFeeHbar: 1, // Token creation costs ~1 HBAR
+            warnings: [],
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const decimals = input.decimals ?? 0;
+            const tx = new sdk_1.TokenCreateTransaction()
+                .setTokenName(input.name)
+                .setTokenSymbol(input.symbol)
+                .setDecimals(decimals)
+                .setInitialSupply(input.initialSupply)
+                .setTreasuryAccountId(agent.accountId)
+                .setAdminKey(agent.privateKey.publicKey)
+                .setSupplyKey(agent.privateKey.publicKey)
+                .setTokenType(sdk_1.TokenType.FungibleCommon)
+                .setSupplyType(sdk_1.TokenSupplyType.Infinite);
+            if (input.memo) {
+                tx.setTokenMemo(input.memo);
+            }
+            const response = await tx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                return {
+                    ok: false,
+                    error: receipt.status.toString(),
+                    details: `Token creation failed with status: ${receipt.status.toString()}`,
+                };
+            }
+            const tokenId = receipt.tokenId;
+            if (!tokenId) {
+                return {
+                    ok: false,
+                    error: "NO_TOKEN_ID",
+                    details: "Transaction succeeded but no token ID was returned.",
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Created token ${input.symbol} (${tokenId.toString()}) with initial supply ${input.initialSupply.toLocaleString()}`,
+                txId,
+                receipt: {
+                    status: receipt.status.toString(),
+                },
+                data: {
+                    tokenId: tokenId.toString(),
+                    name: input.name,
+                    symbol: input.symbol,
+                    decimals,
+                    initialSupply: input.initialSupply,
+                    treasury: agent.accountId.toString(),
+                    hasAdminKey: true,
+                    hasSupplyKey: true,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const knownErrors = {
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the token creation fee (~1 HBAR).",
+                INVALID_TOKEN_SYMBOL: "Token symbol is invalid.",
+                INVALID_TOKEN_NAME: "Token name is invalid.",
+                TOKEN_ALREADY_ASSOCIATED_TO_ACCOUNT: "This token is already associated with the treasury.",
+                TOKENS_PER_ACCOUNT_LIMIT_EXCEEDED: "The treasury account has reached its token association limit.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "CREATE_TOKEN_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = createTokenAction;
+//# sourceMappingURL=create_token.js.map

package/dist/actions/create_token.js.map

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

package/dist/actions/get_balance.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const getBalanceAction: Action;
+export default getBalanceAction;
+//# sourceMappingURL=get_balance.d.ts.map

package/dist/actions/get_balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_balance.d.ts","sourceRoot":"","sources":["../../src/actions/get_balance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAGvD,QAAA,MAAM,gBAAgB,EAAE,MAoHvB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/actions/get_balance.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const getBalanceAction = {
+    name: "GET_BALANCE",
+    similes: [
+        "check balance",
+        "get balance",
+        "account balance",
+        "how much hbar",
+        "show balance",
+        "wallet balance",
+    ],
+    description: "Get the HBAR and token balances for a Hedera account. If no account ID is provided, returns the agent's own balance.",
+    examples: [
+        [
+            {
+                input: {},
+                output: {
+                    ok: true,
+                    summary: "Balance for 0.0.12345: 150.5 ℏ",
+                    data: {
+                        accountId: "0.0.12345",
+                        hbarBalance: "150.5",
+                        tokens: [],
+                    },
+                },
+                explanation: "Get the agent's own balance when no accountId is specified",
+            },
+        ],
+        [
+            {
+                input: { accountId: "0.0.98765" },
+                output: {
+                    ok: true,
+                    summary: "Balance for 0.0.98765: 42.0 ℏ",
+                    data: {
+                        accountId: "0.0.98765",
+                        hbarBalance: "42.0",
+                        tokens: [
+                            { tokenId: "0.0.55555", balance: "1000", decimals: 2 },
+                        ],
+                    },
+                },
+                explanation: "Get balance for a specific account, including tokens",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        accountId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Account ID format (must be 0.0.X)")
+            .optional()
+            .describe("The Hedera Account ID to check (e.g. 0.0.12345). Defaults to the agent's own account."),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const targetId = input.accountId
+                ? sdk_1.AccountId.fromString(input.accountId)
+                : agent.accountId;
+            const balance = await new sdk_1.AccountBalanceQuery()
+                .setAccountId(targetId)
+                .execute(agent.client);
+            // Build token list from the balance map
+            const tokens = [];
+            if (balance.tokens) {
+                const tokenJson = balance.toJSON().tokens;
+                for (const t of tokenJson) {
+                    tokens.push({
+                        tokenId: t.tokenId,
+                        balance: t.balance,
+                        decimals: t.decimals,
+                    });
+                }
+            }
+            const hbarStr = balance.hbars.toString();
+            const accountStr = targetId.toString();
+            return {
+                ok: true,
+                summary: `Balance for ${accountStr}: ${hbarStr}`,
+                data: {
+                    accountId: accountStr,
+                    hbarBalance: hbarStr,
+                    tokens,
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Parse known Hedera error codes
+            const knownErrors = {
+                INVALID_ACCOUNT_ID: "The account ID does not exist on this network.",
+                ACCOUNT_DELETED: "This account has been deleted.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "BALANCE_QUERY_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = getBalanceAction;
+//# sourceMappingURL=get_balance.js.map

package/dist/actions/get_balance.js.map

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