@kasarlabs/starknet-rpc-mcp 0.1.0

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 (79) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +38 -0
  3. package/bin/starknet-rpc-mcp.js +14 -0
  4. package/build/index.d.ts +2 -0
  5. package/build/index.js +169 -0
  6. package/build/index.js.map +1 -0
  7. package/build/lib/types/index.d.ts +85 -0
  8. package/build/lib/types/index.js +51 -0
  9. package/build/lib/types/index.js.map +1 -0
  10. package/build/schemas/index.d.ts +88 -0
  11. package/build/schemas/index.js +78 -0
  12. package/build/schemas/index.js.map +1 -0
  13. package/build/tools/getBlockLatestAccepted.d.ts +10 -0
  14. package/build/tools/getBlockLatestAccepted.js +16 -0
  15. package/build/tools/getBlockLatestAccepted.js.map +1 -0
  16. package/build/tools/getBlockNumber.d.ts +10 -0
  17. package/build/tools/getBlockNumber.js +16 -0
  18. package/build/tools/getBlockNumber.js.map +1 -0
  19. package/build/tools/getBlockStateUpdate.d.ts +12 -0
  20. package/build/tools/getBlockStateUpdate.js +16 -0
  21. package/build/tools/getBlockStateUpdate.js.map +1 -0
  22. package/build/tools/getBlockTransactionCount.d.ts +12 -0
  23. package/build/tools/getBlockTransactionCount.js +16 -0
  24. package/build/tools/getBlockTransactionCount.js.map +1 -0
  25. package/build/tools/getBlockTransactionsTraces.d.ts +12 -0
  26. package/build/tools/getBlockTransactionsTraces.js +16 -0
  27. package/build/tools/getBlockTransactionsTraces.js.map +1 -0
  28. package/build/tools/getBlockWithReceipts.d.ts +12 -0
  29. package/build/tools/getBlockWithReceipts.js +16 -0
  30. package/build/tools/getBlockWithReceipts.js.map +1 -0
  31. package/build/tools/getBlockWithTxHashes.d.ts +12 -0
  32. package/build/tools/getBlockWithTxHashes.js +16 -0
  33. package/build/tools/getBlockWithTxHashes.js.map +1 -0
  34. package/build/tools/getBlockWithTxs.d.ts +12 -0
  35. package/build/tools/getBlockWithTxs.js +16 -0
  36. package/build/tools/getBlockWithTxs.js.map +1 -0
  37. package/build/tools/getChainId.d.ts +10 -0
  38. package/build/tools/getChainId.js +16 -0
  39. package/build/tools/getChainId.js.map +1 -0
  40. package/build/tools/getClass.d.ts +13 -0
  41. package/build/tools/getClass.js +16 -0
  42. package/build/tools/getClass.js.map +1 -0
  43. package/build/tools/getClassAt.d.ts +13 -0
  44. package/build/tools/getClassAt.js +16 -0
  45. package/build/tools/getClassAt.js.map +1 -0
  46. package/build/tools/getClassHash.d.ts +13 -0
  47. package/build/tools/getClassHash.js +16 -0
  48. package/build/tools/getClassHash.js.map +1 -0
  49. package/build/tools/getClassHashAt.d.ts +13 -0
  50. package/build/tools/getClassHashAt.js +16 -0
  51. package/build/tools/getClassHashAt.js.map +1 -0
  52. package/build/tools/getNonceForAddress.d.ts +13 -0
  53. package/build/tools/getNonceForAddress.js +16 -0
  54. package/build/tools/getNonceForAddress.js.map +1 -0
  55. package/build/tools/getSpecVersion.d.ts +10 -0
  56. package/build/tools/getSpecVersion.js +16 -0
  57. package/build/tools/getSpecVersion.js.map +1 -0
  58. package/build/tools/getStorageAt.d.ts +14 -0
  59. package/build/tools/getStorageAt.js +16 -0
  60. package/build/tools/getStorageAt.js.map +1 -0
  61. package/build/tools/getSyncingStats.d.ts +10 -0
  62. package/build/tools/getSyncingStats.js +16 -0
  63. package/build/tools/getSyncingStats.js.map +1 -0
  64. package/build/tools/getTransactionByBlockIdAndIndex.d.ts +13 -0
  65. package/build/tools/getTransactionByBlockIdAndIndex.js +16 -0
  66. package/build/tools/getTransactionByBlockIdAndIndex.js.map +1 -0
  67. package/build/tools/getTransactionByHash.d.ts +12 -0
  68. package/build/tools/getTransactionByHash.js +16 -0
  69. package/build/tools/getTransactionByHash.js.map +1 -0
  70. package/build/tools/getTransactionReceipt.d.ts +12 -0
  71. package/build/tools/getTransactionReceipt.js +16 -0
  72. package/build/tools/getTransactionReceipt.js.map +1 -0
  73. package/build/tools/getTransactionStatus.d.ts +12 -0
  74. package/build/tools/getTransactionStatus.js +16 -0
  75. package/build/tools/getTransactionStatus.js.map +1 -0
  76. package/build/tools/getTransactionTrace.d.ts +12 -0
  77. package/build/tools/getTransactionTrace.js +16 -0
  78. package/build/tools/getTransactionTrace.js.map +1 -0
  79. package/package.json +43 -0
@@ -0,0 +1,16 @@
1
+ export const getTransactionStatus = async (provider, params) => {
2
+ try {
3
+ const transactionStatus = await provider.getTransactionStatus(params.transactionHash);
4
+ return {
5
+ status: 'success',
6
+ transactionStatus: transactionStatus,
7
+ };
8
+ }
9
+ catch (error) {
10
+ return {
11
+ status: 'failure',
12
+ error: error instanceof Error ? error.message : 'Unknown error',
13
+ };
14
+ }
15
+ };
16
+ //# sourceMappingURL=getTransactionStatus.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getTransactionStatus.js","sourceRoot":"","sources":["../../src/tools/getTransactionStatus.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,QAAqB,EACrB,MAAmC,EACnC,EAAE;IACF,IAAI,CAAC;QACH,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAC3D,MAAM,CAAC,eAAe,CACvB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,iBAAiB,EAAE,iBAAwB;SAC5C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { RpcProvider } from 'starknet';
2
+ export declare const getTransactionTrace: (provider: RpcProvider, params: {
3
+ transactionHash: string;
4
+ }) => Promise<{
5
+ status: string;
6
+ transactionTrace: import("starknet").TRANSACTION_TRACE;
7
+ error?: undefined;
8
+ } | {
9
+ status: string;
10
+ error: string;
11
+ transactionTrace?: undefined;
12
+ }>;
@@ -0,0 +1,16 @@
1
+ export const getTransactionTrace = async (provider, params) => {
2
+ try {
3
+ const transactionTrace = await provider.getTransactionTrace(params.transactionHash);
4
+ return {
5
+ status: 'success',
6
+ transactionTrace,
7
+ };
8
+ }
9
+ catch (error) {
10
+ return {
11
+ status: 'failure',
12
+ error: error instanceof Error ? error.message : 'Unknown error',
13
+ };
14
+ }
15
+ };
16
+ //# sourceMappingURL=getTransactionTrace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getTransactionTrace.js","sourceRoot":"","sources":["../../src/tools/getTransactionTrace.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,QAAqB,EACrB,MAAmC,EACnC,EAAE;IACF,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CACzD,MAAM,CAAC,eAAe,CACvB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,43 @@
1
+ {
2
+ "name": "@kasarlabs/starknet-rpc-mcp",
3
+ "version": "0.1.0",
4
+ "main": "index.js",
5
+ "type": "module",
6
+ "bin": {
7
+ "starknet-rpc-mcp": "./bin/starknet-rpc-mcp.js"
8
+ },
9
+ "scripts": {
10
+ "build": "tsc && chmod 755 build/index.js",
11
+ "clean": "rm -rf build",
12
+ "clean:all": "rm -rf build node_modules",
13
+ "start": "node build/index.js"
14
+ },
15
+ "files": [
16
+ "build"
17
+ ],
18
+ "dependencies": {
19
+ "@kasarlabs/ask-starknet-core": "0.1.0",
20
+ "@langchain/core": "^0.3.42",
21
+ "@modelcontextprotocol/sdk": "^1.11.2",
22
+ "dotenv": "^16.4.7",
23
+ "starknet": "^7.6.4",
24
+ "winston": "^3.17.0",
25
+ "zod": "^3.24.2"
26
+ },
27
+ "devDependencies": {
28
+ "@types/node": "^22.13.10",
29
+ "typescript": "^5.8.2"
30
+ },
31
+ "keywords": [
32
+ "mcp",
33
+ "starknet",
34
+ "rpc"
35
+ ],
36
+ "author": "kasarlabs",
37
+ "license": "MIT",
38
+ "description": "MCP server for direct blockchain interaction via RPC methods, providing access to on-chain data and state.",
39
+ "publishConfig": {
40
+ "access": "public"
41
+ },
42
+ "gitHead": "2239ec60f8e369abd318807cecd22fe97c0ab917"
43
+ }