@ton/mcp 0.1.15-alpha.2 → 0.1.15-alpha.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +34 -3
  2. package/USAGE_EXAMPLES.md +360 -0
  3. package/dist/cli.d.ts +29 -1
  4. package/dist/cli.d.ts.map +1 -1
  5. package/dist/cli.js +36643 -8054
  6. package/dist/contracts/agentic_wallet/AgenticWalletAdapter.d.ts +17 -10
  7. package/dist/contracts/agentic_wallet/AgenticWalletAdapter.d.ts.map +1 -1
  8. package/dist/factory.d.ts +5 -1
  9. package/dist/factory.d.ts.map +1 -1
  10. package/dist/index.cjs +36604 -8026
  11. package/dist/index.js +36569 -7995
  12. package/dist/registry/config.d.ts +4 -1
  13. package/dist/registry/config.d.ts.map +1 -1
  14. package/dist/registry/protected-file.d.ts +16 -0
  15. package/dist/registry/protected-file.d.ts.map +1 -0
  16. package/dist/runtime/wallet-runtime.d.ts +3 -1
  17. package/dist/runtime/wallet-runtime.d.ts.map +1 -1
  18. package/dist/serverless.cjs +36784 -8206
  19. package/dist/serverless.js +36749 -8175
  20. package/dist/services/AgenticSetupSessionManager.d.ts +8 -7
  21. package/dist/services/AgenticSetupSessionManager.d.ts.map +1 -1
  22. package/dist/services/McpWalletService.d.ts +34 -1
  23. package/dist/services/McpWalletService.d.ts.map +1 -1
  24. package/dist/services/WalletRegistryService.d.ts +3 -1
  25. package/dist/services/WalletRegistryService.d.ts.map +1 -1
  26. package/dist/suppress-punycode-deprecation.d.ts +9 -0
  27. package/dist/suppress-punycode-deprecation.d.ts.map +1 -0
  28. package/dist/tools/address-tools.d.ts +6 -6
  29. package/dist/tools/address-tools.d.ts.map +1 -1
  30. package/dist/tools/agentic-onboarding-tools.d.ts +4 -4
  31. package/dist/tools/balance-tools.d.ts.map +1 -1
  32. package/dist/tools/index.d.ts +1 -0
  33. package/dist/tools/index.d.ts.map +1 -1
  34. package/dist/tools/sanitize.d.ts.map +1 -1
  35. package/dist/tools/ton-proof-tools.d.ts +37 -0
  36. package/dist/tools/ton-proof-tools.d.ts.map +1 -0
  37. package/dist/tools/transfer-tools.d.ts +74 -0
  38. package/dist/tools/transfer-tools.d.ts.map +1 -1
  39. package/dist/tools/wallet-management-tools.d.ts +4 -4
  40. package/dist/utils/agentic.d.ts +1 -0
  41. package/dist/utils/agentic.d.ts.map +1 -1
  42. package/dist/utils/proxy.d.ts +9 -0
  43. package/dist/utils/proxy.d.ts.map +1 -0
  44. package/dist/utils/ton-client.d.ts.map +1 -1
  45. package/llms.txt +39 -10
  46. package/package.json +23 -12
  47. package/skills/ton-balance/SKILL.md +4 -4
  48. package/skills/ton-cli/SKILL.md +30 -13
  49. package/skills/ton-create-wallet/SKILL.md +11 -9
  50. package/skills/ton-manage-wallets/SKILL.md +5 -2
  51. package/skills/ton-nfts/SKILL.md +4 -2
  52. package/skills/ton-proof/SKILL.md +46 -0
  53. package/skills/ton-send/SKILL.md +5 -3
  54. package/skills/ton-swap/SKILL.md +6 -4
  55. package/skills/ton-xstocks/SKILL.md +111 -0
@@ -6,8 +6,13 @@
6
6
  *
7
7
  */
8
8
  import { Address, Cell } from '@ton/core';
9
- import type { ApiClient, WalletAdapter, WalletSigner, Network, PreparedSignData, ProofMessage, TransactionRequest, UserFriendlyAddress, Hex, Base64String, Feature, WalletId } from '@ton/walletkit';
9
+ import type { ApiClient, WalletAdapter, WalletSigner, Network, PreparedSignData, ProofMessage, TransactionRequest, UserFriendlyAddress, Hex, Base64String, Feature, WalletId, SignedSendTransactionOptions } from '@ton/walletkit';
10
10
  export declare const defaultAgenticWorkchain = 0;
11
+ type AgenticWalletAuthType = 'external' | 'internal';
12
+ interface CreateAgenticBodyOptions extends SignedSendTransactionOptions {
13
+ validUntil: number | undefined;
14
+ authType: AgenticWalletAuthType;
15
+ }
11
16
  export interface AgenticWalletAdapterConfig {
12
17
  signer: WalletSigner;
13
18
  publicKey: Hex;
@@ -17,6 +22,7 @@ export interface AgenticWalletAdapterConfig {
17
22
  walletAddress?: Address;
18
23
  walletNftIndex?: bigint;
19
24
  collectionAddress?: Address;
25
+ onWalletNftIndexResolved?: (walletNftIndex: bigint) => void | Promise<void>;
20
26
  }
21
27
  export declare class AgenticWalletAdapter implements WalletAdapter {
22
28
  private signer;
@@ -25,7 +31,7 @@ export declare class AgenticWalletAdapter implements WalletAdapter {
25
31
  readonly publicKey: Hex;
26
32
  readonly version = "agentic";
27
33
  readonly address: Address;
28
- private readonly walletInit?;
34
+ private walletInit?;
29
35
  private walletNftIndexCache?;
30
36
  static create(signer: WalletSigner, options: {
31
37
  client: ApiClient;
@@ -34,6 +40,7 @@ export declare class AgenticWalletAdapter implements WalletAdapter {
34
40
  walletAddress?: string | Address;
35
41
  walletNftIndex?: bigint;
36
42
  collectionAddress?: string | Address;
43
+ onWalletNftIndexResolved?: (walletNftIndex: bigint) => void | Promise<void>;
37
44
  }): Promise<AgenticWalletAdapter>;
38
45
  constructor(config: AgenticWalletAdapterConfig);
39
46
  getPublicKey(): Hex;
@@ -45,18 +52,18 @@ export declare class AgenticWalletAdapter implements WalletAdapter {
45
52
  }): UserFriendlyAddress;
46
53
  getWalletId(): WalletId;
47
54
  getStateInit(): Promise<Base64String>;
48
- getSignedSendTransaction(input: TransactionRequest, options: {
49
- fakeSignature: boolean;
50
- }): Promise<Base64String>;
55
+ private ensureWalletInit;
56
+ getSignedSendTransaction(input: TransactionRequest, options?: SignedSendTransactionOptions): Promise<Base64String>;
57
+ getSignedSignMessage(input: TransactionRequest, options?: SignedSendTransactionOptions): Promise<Base64String>;
51
58
  getSeqno(): Promise<number>;
52
59
  getWalletNftIndex(): Promise<bigint>;
53
- private extractOutActions;
54
- createSignedBody(seqno: number, walletNftIndex: bigint, outActions: Cell | null, options: {
55
- validUntil: number | undefined;
56
- fakeSignature: boolean;
57
- }): Promise<Cell>;
60
+ private createSignedTransferBody;
61
+ private createTransferAction;
62
+ private resolveValidUntil;
63
+ createSignedBody(seqno: number, walletNftIndex: bigint, outActions: Cell | null, options: CreateAgenticBodyOptions): Promise<Cell>;
58
64
  getSignedSignData(input: PreparedSignData): Promise<Hex>;
59
65
  getSignedTonProof(input: ProofMessage): Promise<Hex>;
60
66
  getSupportedFeatures(): Feature[] | undefined;
61
67
  }
68
+ export {};
62
69
  //# sourceMappingURL=AgenticWalletAdapter.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"AgenticWalletAdapter.d.ts","sourceRoot":"","sources":["../../../src/contracts/agentic_wallet/AgenticWalletAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACH,OAAO,EAEP,IAAI,EAOP,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EACR,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,GAAG,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACX,MAAM,gBAAgB,CAAC;AAexB,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,0BAA0B;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAsCD,qBAAa,oBAAqB,YAAW,aAAa;IACtD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA6B;IAE3C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,SAAgB,SAAS,EAAE,GAAG,CAAC;IAC/B,SAAgB,OAAO,aAAa;IACpC,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAA6B;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAAS;WAExB,MAAM,CACf,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE;QACL,MAAM,EAAE,SAAS,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACjC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACxC,GACF,OAAO,CAAC,oBAAoB,CAAC;gBAiBpB,MAAM,EAAE,0BAA0B;IAsC9C,YAAY,IAAI,GAAG;IAInB,SAAS,IAAI,SAAS;IAIhB,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjD,UAAU,IAAI,OAAO;IAIrB,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB;IAIhE,WAAW,IAAI,QAAQ;IAIjB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAarC,wBAAwB,CAC1B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,GACpC,OAAO,CAAC,YAAY,CAAC;IAsFlB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAS3B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAe1C,OAAO,CAAC,iBAAiB;IAKnB,gBAAgB,CAClB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,IAAI,GAAG,IAAI,EACvB,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GACpE,OAAO,CAAC,IAAI,CAAC;IAsBV,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAIxD,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAK1D,oBAAoB,IAAI,OAAO,EAAE,GAAG,SAAS;CAYhD"}
1
+ {"version":3,"file":"AgenticWalletAdapter.d.ts","sourceRoot":"","sources":["../../../src/contracts/agentic_wallet/AgenticWalletAdapter.ts"],"names":[],"mappings":"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"}
package/dist/factory.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  * Factory function for creating configured MCP server instances
10
10
  */
11
11
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
12
- import type { WalletAdapter } from '@ton/walletkit';
12
+ import type { BaseProvider, ProviderInput, WalletAdapter } from '@ton/walletkit';
13
13
  import type { IContactResolver } from './types/contacts.js';
14
14
  import type { NetworkConfig } from './services/McpWalletService.js';
15
15
  import { McpWalletService } from './services/McpWalletService.js';
@@ -40,6 +40,10 @@ export interface TonMcpFactoryConfig {
40
40
  * Optional shared session manager for agentic onboarding callback handling.
41
41
  */
42
42
  agenticSessionManager?: AgenticSetupSessionManager;
43
+ /**
44
+ * Optional additional providers to register on the wallet kit instance (e.g. custom swap or staking providers).
45
+ */
46
+ providers?: Array<ProviderInput<BaseProvider>>;
43
47
  }
44
48
  export declare function createTonWalletMCP(config: TonMcpFactoryConfig): Promise<McpServer>;
45
49
  export declare function createShutdownHandler(walletService: McpWalletService): () => Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EACH,0BAA0B,EAE7B,MAAM,0CAA0C,CAAC;AAmBlD,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;IAEF;;OAEG;IACH,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;CACtD;AAcD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqPxF;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAE1F"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EACH,0BAA0B,EAE7B,MAAM,0CAA0C,CAAC;AAoBlD,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;IAEF;;OAEG;IACH,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IAEnD;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CAClD;AAcD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqQxF;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAE1F"}