web3-tools-mcp 1.5.0 → 2.0.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.
- package/CHANGELOG.md +95 -0
- package/README.md +346 -164
- package/dist/anvil.d.ts +1 -1
- package/dist/anvil.d.ts.map +1 -1
- package/dist/anvil.js +11 -9
- package/dist/anvil.js.map +1 -1
- package/dist/chain-meta.d.ts.map +1 -1
- package/dist/chain-meta.js +7 -3
- package/dist/chain-meta.js.map +1 -1
- package/dist/chains.d.ts +960 -0
- package/dist/chains.d.ts.map +1 -0
- package/dist/chains.js +108 -0
- package/dist/chains.js.map +1 -0
- package/dist/client.d.ts +10 -1717
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +33 -216
- package/dist/client.js.map +1 -1
- package/dist/http-server.d.ts +18 -0
- package/dist/http-server.d.ts.map +1 -0
- package/dist/http-server.js +89 -0
- package/dist/http-server.js.map +1 -0
- package/dist/index.js +77 -32
- package/dist/index.js.map +1 -1
- package/dist/kv-storage.d.ts +23 -0
- package/dist/kv-storage.d.ts.map +1 -0
- package/dist/kv-storage.js +69 -0
- package/dist/kv-storage.js.map +1 -0
- package/dist/oauth.d.ts +31 -0
- package/dist/oauth.d.ts.map +1 -0
- package/dist/oauth.js +227 -0
- package/dist/oauth.js.map +1 -0
- package/dist/preview.d.ts.map +1 -1
- package/dist/preview.js +14 -4
- package/dist/preview.js.map +1 -1
- package/dist/tools/advanced.d.ts +4 -4
- package/dist/tools/advanced.d.ts.map +1 -1
- package/dist/tools/advanced.js +228 -247
- package/dist/tools/advanced.js.map +1 -1
- package/dist/tools/balance.d.ts +1 -1
- package/dist/tools/balance.d.ts.map +1 -1
- package/dist/tools/balance.js +97 -103
- package/dist/tools/balance.js.map +1 -1
- package/dist/tools/contract-info.d.ts +3 -3
- package/dist/tools/contract-info.d.ts.map +1 -1
- package/dist/tools/contract-info.js +150 -161
- package/dist/tools/contract-info.js.map +1 -1
- package/dist/tools/contract.d.ts +4 -4
- package/dist/tools/contract.d.ts.map +1 -1
- package/dist/tools/contract.js +91 -110
- package/dist/tools/contract.js.map +1 -1
- package/dist/tools/ens.d.ts +6 -6
- package/dist/tools/ens.d.ts.map +1 -1
- package/dist/tools/ens.js +239 -297
- package/dist/tools/ens.js.map +1 -1
- package/dist/tools/gas.d.ts +4 -4
- package/dist/tools/gas.d.ts.map +1 -1
- package/dist/tools/gas.js +90 -138
- package/dist/tools/gas.js.map +1 -1
- package/dist/tools/index.d.ts +1 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/logs.d.ts +1 -1
- package/dist/tools/logs.d.ts.map +1 -1
- package/dist/tools/logs.js +36 -37
- package/dist/tools/logs.js.map +1 -1
- package/dist/tools/signatures.d.ts.map +1 -1
- package/dist/tools/signatures.js +67 -89
- package/dist/tools/signatures.js.map +1 -1
- package/dist/tools/transactions.d.ts +48 -4
- package/dist/tools/transactions.d.ts.map +1 -1
- package/dist/tools/transactions.js +228 -44
- package/dist/tools/transactions.js.map +1 -1
- package/dist/types.d.ts +2 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils.d.ts +3 -8
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +36 -98
- package/dist/utils.js.map +1 -1
- package/dist/wallet-client.d.ts +11 -1
- package/dist/wallet-client.d.ts.map +1 -1
- package/dist/wallet-client.js +27 -9
- package/dist/wallet-client.js.map +1 -1
- package/dist/walletconnect.d.ts +52 -0
- package/dist/walletconnect.d.ts.map +1 -0
- package/dist/walletconnect.js +221 -0
- package/dist/walletconnect.js.map +1 -0
- package/package.json +21 -9
- package/src/anvil.ts +15 -18
- package/src/chain-meta.ts +8 -4
- package/src/chains.ts +145 -0
- package/src/client.ts +39 -252
- package/src/http-server.ts +117 -0
- package/src/index.ts +98 -49
- package/src/kv-storage.ts +83 -0
- package/src/oauth.ts +270 -0
- package/src/preview.ts +15 -14
- package/src/tools/advanced.ts +195 -213
- package/src/tools/balance.ts +103 -108
- package/src/tools/contract-info.ts +163 -184
- package/src/tools/contract.ts +123 -144
- package/src/tools/ens.ts +290 -345
- package/src/tools/gas.ts +122 -170
- package/src/tools/index.ts +2 -2
- package/src/tools/logs.ts +45 -43
- package/src/tools/signatures.ts +68 -86
- package/src/tools/transactions.ts +283 -50
- package/src/types.ts +2 -15
- package/src/utils.ts +56 -127
- package/src/wallet-client.ts +31 -9
- package/src/walletconnect.ts +269 -0
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAQ,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAa9C,6FAA6F;AAC7F,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEzD,qBAAa,aAAa;IAGZ,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,OAAO,CAAqC;gBAEhC,MAAM,EAAE,MAAM;IAElC,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY;IAc7C,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIvC,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIxC,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIzD,yEAAyE;IACzE,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,SAAK,GAAG,MAAM,GAAG,SAAS;CAIjE;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAGrE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD"}
|
package/dist/client.js
CHANGED
|
@@ -1,237 +1,54 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
|
|
1
|
+
import { createPublicClient, http } from 'viem';
|
|
2
|
+
import { CHAINS } from './chains.js';
|
|
3
|
+
export { SUPPORTED_CHAINS } from './chains.js';
|
|
4
|
+
/** Custom URL first, then whichever provider key is configured, then the public endpoint. */
|
|
4
5
|
function getRpcUrl(chainName, config) {
|
|
5
|
-
|
|
6
|
-
if (
|
|
7
|
-
return
|
|
8
|
-
}
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
? `https://mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
15
|
-
: 'https://ethereum-rpc.publicnode.com',
|
|
16
|
-
base: config.alchemyApiKey
|
|
17
|
-
? `https://base-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
18
|
-
: 'https://base-rpc.publicnode.com',
|
|
19
|
-
arbitrum: config.alchemyApiKey
|
|
20
|
-
? `https://arb-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
21
|
-
: config.infuraApiKey
|
|
22
|
-
? `https://arbitrum-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
23
|
-
: 'https://arb1.arbitrum.io/rpc',
|
|
24
|
-
polygon: config.alchemyApiKey
|
|
25
|
-
? `https://polygon-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
26
|
-
: config.infuraApiKey
|
|
27
|
-
? `https://polygon-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
28
|
-
: 'https://polygon-rpc.com',
|
|
29
|
-
optimism: config.alchemyApiKey
|
|
30
|
-
? `https://opt-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
31
|
-
: config.infuraApiKey
|
|
32
|
-
? `https://optimism-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
33
|
-
: 'https://mainnet.optimism.io',
|
|
34
|
-
avalanche: config.alchemyApiKey
|
|
35
|
-
? `https://avax-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
36
|
-
: config.infuraApiKey
|
|
37
|
-
? `https://avalanche-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
38
|
-
: 'https://api.avax.network/ext/bc/C/rpc',
|
|
39
|
-
bnb: config.alchemyApiKey
|
|
40
|
-
? `https://bnb-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
41
|
-
: config.infuraApiKey
|
|
42
|
-
? `https://bsc-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
43
|
-
: 'https://bsc-dataseed.bnbchain.org',
|
|
44
|
-
gnosis: config.alchemyApiKey
|
|
45
|
-
? `https://gnosis-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
46
|
-
: 'https://rpc.gnosischain.com',
|
|
47
|
-
sonic: config.alchemyApiKey
|
|
48
|
-
? `https://sonic-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
49
|
-
: 'https://rpc.soniclabs.com',
|
|
50
|
-
zksync: config.alchemyApiKey
|
|
51
|
-
? `https://zksync-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
52
|
-
: config.infuraApiKey
|
|
53
|
-
? `https://zksync-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
54
|
-
: 'https://mainnet.era.zksync.io',
|
|
55
|
-
linea: config.alchemyApiKey
|
|
56
|
-
? `https://linea-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
57
|
-
: config.infuraApiKey
|
|
58
|
-
? `https://linea-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
59
|
-
: 'https://rpc.linea.build',
|
|
60
|
-
unichain: config.alchemyApiKey
|
|
61
|
-
? `https://unichain-mainnet.g.alchemy.com/v2/${config.alchemyApiKey}`
|
|
62
|
-
: config.infuraApiKey
|
|
63
|
-
? `https://unichain-mainnet.infura.io/v3/${config.infuraApiKey}`
|
|
64
|
-
: 'https://sepolia.unichain.org',
|
|
65
|
-
localhost: 'http://localhost:8545'
|
|
66
|
-
};
|
|
67
|
-
return enhancedRpcs[chainName] ?? 'https://eth.llamarpc.com';
|
|
6
|
+
const custom = config.customRpcUrls?.[chainName];
|
|
7
|
+
if (custom)
|
|
8
|
+
return custom;
|
|
9
|
+
const { alchemy, infura, fallback } = CHAINS[chainName];
|
|
10
|
+
if (alchemy && config.alchemyApiKey)
|
|
11
|
+
return `https://${alchemy}.g.alchemy.com/v2/${config.alchemyApiKey}`;
|
|
12
|
+
if (infura && config.infuraApiKey)
|
|
13
|
+
return `https://${infura}.infura.io/v3/${config.infuraApiKey}`;
|
|
14
|
+
return fallback;
|
|
68
15
|
}
|
|
69
|
-
// Supported chains with their RPC endpoints (now dynamic)
|
|
70
|
-
export const CHAINS = (config) => ({
|
|
71
|
-
mainnet: {
|
|
72
|
-
chain: mainnet,
|
|
73
|
-
get rpc() {
|
|
74
|
-
return getRpcUrl('mainnet', config);
|
|
75
|
-
}
|
|
76
|
-
},
|
|
77
|
-
base: {
|
|
78
|
-
chain: base,
|
|
79
|
-
get rpc() {
|
|
80
|
-
return getRpcUrl('base', config);
|
|
81
|
-
}
|
|
82
|
-
},
|
|
83
|
-
arbitrum: {
|
|
84
|
-
chain: arbitrum,
|
|
85
|
-
get rpc() {
|
|
86
|
-
return getRpcUrl('arbitrum', config);
|
|
87
|
-
}
|
|
88
|
-
},
|
|
89
|
-
polygon: {
|
|
90
|
-
chain: polygon,
|
|
91
|
-
get rpc() {
|
|
92
|
-
return getRpcUrl('polygon', config);
|
|
93
|
-
}
|
|
94
|
-
},
|
|
95
|
-
optimism: {
|
|
96
|
-
chain: optimism,
|
|
97
|
-
get rpc() {
|
|
98
|
-
return getRpcUrl('optimism', config);
|
|
99
|
-
}
|
|
100
|
-
},
|
|
101
|
-
avalanche: {
|
|
102
|
-
chain: avalanche,
|
|
103
|
-
get rpc() {
|
|
104
|
-
return getRpcUrl('avalanche', config);
|
|
105
|
-
}
|
|
106
|
-
},
|
|
107
|
-
bnb: {
|
|
108
|
-
chain: bsc,
|
|
109
|
-
get rpc() {
|
|
110
|
-
return getRpcUrl('bnb', config);
|
|
111
|
-
}
|
|
112
|
-
},
|
|
113
|
-
gnosis: {
|
|
114
|
-
chain: gnosis,
|
|
115
|
-
get rpc() {
|
|
116
|
-
return getRpcUrl('gnosis', config);
|
|
117
|
-
}
|
|
118
|
-
},
|
|
119
|
-
sonic: {
|
|
120
|
-
chain: sonic,
|
|
121
|
-
get rpc() {
|
|
122
|
-
return getRpcUrl('sonic', config);
|
|
123
|
-
}
|
|
124
|
-
},
|
|
125
|
-
zksync: {
|
|
126
|
-
chain: zksync,
|
|
127
|
-
get rpc() {
|
|
128
|
-
return getRpcUrl('zksync', config);
|
|
129
|
-
}
|
|
130
|
-
},
|
|
131
|
-
linea: {
|
|
132
|
-
chain: linea,
|
|
133
|
-
get rpc() {
|
|
134
|
-
return getRpcUrl('linea', config);
|
|
135
|
-
}
|
|
136
|
-
},
|
|
137
|
-
unichain: {
|
|
138
|
-
chain: unichain,
|
|
139
|
-
get rpc() {
|
|
140
|
-
return getRpcUrl('unichain', config);
|
|
141
|
-
}
|
|
142
|
-
},
|
|
143
|
-
localhost: {
|
|
144
|
-
chain: localhost,
|
|
145
|
-
get rpc() {
|
|
146
|
-
return getRpcUrl('localhost', config);
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
});
|
|
150
|
-
// Hypersync URLs for supported chains (localhost is not supported)
|
|
151
|
-
export const HYPERSYNC_URLS = {
|
|
152
|
-
mainnet: 'https://eth.hypersync.xyz', // Chain ID 1
|
|
153
|
-
arbitrum: 'https://arbitrum.hypersync.xyz', // Chain ID 42161
|
|
154
|
-
avalanche: 'https://avalanche.hypersync.xyz', // Chain ID 43114
|
|
155
|
-
base: 'https://base.hypersync.xyz', // Chain ID 8453
|
|
156
|
-
bnb: 'https://bsc.hypersync.xyz', // Chain ID 56
|
|
157
|
-
gnosis: 'https://gnosis.hypersync.xyz', // Chain ID 100
|
|
158
|
-
sonic: 'https://sonic.hypersync.xyz', // Chain ID 146
|
|
159
|
-
optimism: 'https://optimism.hypersync.xyz', // Chain ID 10
|
|
160
|
-
polygon: 'https://polygon.hypersync.xyz', // Chain ID 137
|
|
161
|
-
zksync: 'https://zksync.hypersync.xyz', // Chain ID 324
|
|
162
|
-
linea: 'https://linea.hypersync.xyz', // Chain ID 59144
|
|
163
|
-
unichain: 'https://unichain.hypersync.xyz' // Chain ID 130
|
|
164
|
-
// localhost is not supported by hypersync
|
|
165
|
-
};
|
|
166
|
-
export const SUPPORTED_CHAINS = [
|
|
167
|
-
'mainnet',
|
|
168
|
-
'arbitrum',
|
|
169
|
-
'avalanche',
|
|
170
|
-
'base',
|
|
171
|
-
'bnb',
|
|
172
|
-
'gnosis',
|
|
173
|
-
'sonic',
|
|
174
|
-
'optimism',
|
|
175
|
-
'polygon',
|
|
176
|
-
'zksync',
|
|
177
|
-
'linea',
|
|
178
|
-
'unichain',
|
|
179
|
-
'localhost'
|
|
180
|
-
];
|
|
181
|
-
// Client manager
|
|
182
16
|
export class ClientManager {
|
|
183
|
-
clients = new Map();
|
|
184
17
|
config;
|
|
18
|
+
clients = new Map();
|
|
185
19
|
constructor(config) {
|
|
186
20
|
this.config = config;
|
|
187
21
|
}
|
|
188
22
|
getClient(chainName) {
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
const client = this.clients.get(chainName);
|
|
199
|
-
if (!client) {
|
|
200
|
-
throw new Error(`Failed to create client for chain: ${chainName}`);
|
|
201
|
-
}
|
|
23
|
+
const cached = this.clients.get(chainName);
|
|
24
|
+
if (cached)
|
|
25
|
+
return cached;
|
|
26
|
+
// Cast because a client built for a concrete chain is not assignable to the generic one.
|
|
27
|
+
const client = createPublicClient({
|
|
28
|
+
chain: CHAINS[chainName].chain,
|
|
29
|
+
transport: http(this.getRpcUrl(chainName))
|
|
30
|
+
});
|
|
31
|
+
this.clients.set(chainName, client);
|
|
202
32
|
return client;
|
|
203
33
|
}
|
|
204
34
|
getConfig() {
|
|
205
35
|
return this.config;
|
|
206
36
|
}
|
|
207
|
-
getEtherscanDomain(chainName) {
|
|
208
|
-
const domains = {
|
|
209
|
-
mainnet: 'etherscan.io',
|
|
210
|
-
base: 'basescan.org',
|
|
211
|
-
arbitrum: 'arbiscan.io',
|
|
212
|
-
polygon: 'polygonscan.com',
|
|
213
|
-
optimism: 'optimistic.etherscan.io',
|
|
214
|
-
avalanche: 'snowtrace.io',
|
|
215
|
-
bnb: 'bscscan.com',
|
|
216
|
-
gnosis: 'gnosisscan.io',
|
|
217
|
-
sonic: 'sonicscan.org',
|
|
218
|
-
zksync: 'era.zksync.network',
|
|
219
|
-
linea: 'lineascan.build',
|
|
220
|
-
unichain: 'uniscan.xyz',
|
|
221
|
-
localhost: 'etherscan.io'
|
|
222
|
-
};
|
|
223
|
-
return domains[chainName] || 'etherscan.io';
|
|
224
|
-
}
|
|
225
37
|
getRpcUrl(chainName) {
|
|
226
|
-
|
|
227
|
-
return chains[chainName].rpc;
|
|
38
|
+
return getRpcUrl(chainName, this.config);
|
|
228
39
|
}
|
|
229
40
|
getChainId(chainName) {
|
|
230
|
-
|
|
231
|
-
|
|
41
|
+
return CHAINS[chainName].chain.id;
|
|
42
|
+
}
|
|
43
|
+
getHypersyncUrl(chainName) {
|
|
44
|
+
return CHAINS[chainName].hypersync;
|
|
45
|
+
}
|
|
46
|
+
/** Undefined where the chain has no explorer — a local node, for one. */
|
|
47
|
+
explorerUrl(chainName, path = '') {
|
|
48
|
+
const domain = CHAINS[chainName].explorer;
|
|
49
|
+
return domain ? `https://${domain}${path}` : undefined;
|
|
232
50
|
}
|
|
233
51
|
}
|
|
234
|
-
// Export a global client manager instance
|
|
235
52
|
let clientManager = null;
|
|
236
53
|
export function initializeClientManager(config) {
|
|
237
54
|
clientManager = new ClientManager(config);
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAA;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,6FAA6F;AAC7F,SAAS,SAAS,CAAC,SAAoB,EAAE,MAAc;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IACvD,IAAI,OAAO,IAAI,MAAM,CAAC,aAAa;QAAE,OAAO,WAAW,OAAO,qBAAqB,MAAM,CAAC,aAAa,EAAE,CAAA;IACzG,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY;QAAE,OAAO,WAAW,MAAM,iBAAiB,MAAM,CAAC,YAAY,EAAE,CAAA;IACjG,OAAO,QAAQ,CAAA;AACjB,CAAC;AAKD,MAAM,OAAO,aAAa;IAGJ;IAFZ,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;IAEpD,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,SAAS,CAAC,SAAoB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC1C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,yFAAyF;QACzF,MAAM,MAAM,GAAG,kBAAkB,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK;YAC9B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;SAC3C,CAAiB,CAAA;QAElB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACnC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,SAAS,CAAC,SAAoB;QAC5B,OAAO,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;IAED,UAAU,CAAC,SAAoB;QAC7B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;IACnC,CAAC;IAED,eAAe,CAAC,SAAoB;QAClC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAA;IACpC,CAAC;IAED,yEAAyE;IACzE,WAAW,CAAC,SAAoB,EAAE,IAAI,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAA;QACzC,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IACxD,CAAC;CACF;AAED,IAAI,aAAa,GAAyB,IAAI,CAAA;AAE9C,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
import type { WalletRelay } from 'web3-wallet-relay';
|
|
3
|
+
export interface HttpServerOptions {
|
|
4
|
+
port?: number;
|
|
5
|
+
host?: string;
|
|
6
|
+
token?: string;
|
|
7
|
+
/** Public URL clients reach this server on; OAuth metadata must advertise it. */
|
|
8
|
+
publicUrl?: string;
|
|
9
|
+
/** Serve the signing page on this same server, so browser signing works when hosted. */
|
|
10
|
+
walletRelay?: WalletRelay;
|
|
11
|
+
createMcpServer: () => McpServer;
|
|
12
|
+
}
|
|
13
|
+
export declare function startHttpServer(options: HttpServerOptions): Promise<{
|
|
14
|
+
url: string;
|
|
15
|
+
port: number;
|
|
16
|
+
walletUrl?: string;
|
|
17
|
+
}>;
|
|
18
|
+
//# sourceMappingURL=http-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAmBpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wFAAwF;IACxF,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,eAAe,EAAE,MAAM,SAAS,CAAA;CACjC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiF5H"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { requireBearerAuth } from '@modelcontextprotocol/sdk/server/auth/middleware/bearerAuth.js';
|
|
2
|
+
import { getOAuthProtectedResourceMetadataUrl, mcpAuthRouter } from '@modelcontextprotocol/sdk/server/auth/router.js';
|
|
3
|
+
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
|
|
4
|
+
import express from 'express';
|
|
5
|
+
import { SingleUserOAuthProvider } from './oauth.js';
|
|
6
|
+
/**
|
|
7
|
+
* Serve the MCP over HTTP instead of stdio, so the server can live somewhere other than the
|
|
8
|
+
* machine running the agent. Signing still reaches you: a paired phone over WalletConnect,
|
|
9
|
+
* or the signing page, which is mounted on this same server so one platform port carries
|
|
10
|
+
* both it and /mcp.
|
|
11
|
+
*
|
|
12
|
+
* Two ways in, because clients differ: a static `Authorization: Bearer <MCP_TOKEN>` header
|
|
13
|
+
* (Claude Code), and the OAuth flow the MCP spec defines (claude.ai connectors, which offer
|
|
14
|
+
* no way to send a header). Both end up at the same single credential.
|
|
15
|
+
*
|
|
16
|
+
* Stateless — a server per request — because every tool here is a one-shot call and the
|
|
17
|
+
* signing state lives in the WalletConnect session, not in the transport.
|
|
18
|
+
*/
|
|
19
|
+
const DEFAULT_PORT = 3457;
|
|
20
|
+
export async function startHttpServer(options) {
|
|
21
|
+
const port = options.port ?? Number(process.env.MCP_HTTP_PORT) ?? DEFAULT_PORT;
|
|
22
|
+
const host = options.host ?? process.env.MCP_HTTP_HOST ?? '0.0.0.0';
|
|
23
|
+
const token = options.token ?? process.env.MCP_TOKEN;
|
|
24
|
+
// A reachable MCP server with a paired phone can push signing prompts at that phone. It
|
|
25
|
+
// never runs without a token.
|
|
26
|
+
if (!token) {
|
|
27
|
+
throw new Error('MCP_TOKEN is required to serve MCP over HTTP — anyone reaching the URL could request signatures');
|
|
28
|
+
}
|
|
29
|
+
const publicUrl = options.publicUrl ?? process.env.MCP_PUBLIC_URL ?? `http://localhost:${port}`;
|
|
30
|
+
const issuer = new URL(publicUrl);
|
|
31
|
+
const provider = new SingleUserOAuthProvider(token);
|
|
32
|
+
const app = express();
|
|
33
|
+
app.use(express.json());
|
|
34
|
+
// The login form posts a token, so the authorize route needs form bodies too.
|
|
35
|
+
app.use(express.urlencoded({ extended: false }));
|
|
36
|
+
app.get('/health', (_req, res) => {
|
|
37
|
+
res.json({ status: 'ok' });
|
|
38
|
+
});
|
|
39
|
+
// /authorize, /token, /register, /revoke and the metadata documents a client discovers
|
|
40
|
+
// after a 401.
|
|
41
|
+
app.use(mcpAuthRouter({
|
|
42
|
+
provider,
|
|
43
|
+
issuerUrl: issuer,
|
|
44
|
+
baseUrl: issuer,
|
|
45
|
+
resourceServerUrl: new URL('/mcp', issuer),
|
|
46
|
+
resourceName: 'web3-tools-mcp',
|
|
47
|
+
scopesSupported: []
|
|
48
|
+
}));
|
|
49
|
+
// The metadata document is mounted under the resource path, so the 401 has to advertise
|
|
50
|
+
// that exact URL — a bare /.well-known/oauth-protected-resource 404s, and a client that
|
|
51
|
+
// follows it gives up right where discovery should have started.
|
|
52
|
+
const authenticate = requireBearerAuth({
|
|
53
|
+
verifier: provider,
|
|
54
|
+
resourceMetadataUrl: getOAuthProtectedResourceMetadataUrl(new URL('/mcp', issuer))
|
|
55
|
+
});
|
|
56
|
+
app.all('/mcp', authenticate, async (req, res) => {
|
|
57
|
+
const mcp = options.createMcpServer();
|
|
58
|
+
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
|
|
59
|
+
res.on('close', () => {
|
|
60
|
+
transport.close().catch(() => { });
|
|
61
|
+
mcp.close().catch(() => { });
|
|
62
|
+
});
|
|
63
|
+
try {
|
|
64
|
+
await mcp.connect(transport);
|
|
65
|
+
await transport.handleRequest(req, res, req.body);
|
|
66
|
+
}
|
|
67
|
+
catch (error) {
|
|
68
|
+
console.error('[MCP] Request failed:', error);
|
|
69
|
+
if (!res.headersSent) {
|
|
70
|
+
res.status(500).json({ jsonrpc: '2.0', error: { code: -32603, message: 'Internal error' } });
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
});
|
|
74
|
+
const server = await new Promise((resolve, reject) => {
|
|
75
|
+
const listening = app.listen(port, host, () => resolve(listening));
|
|
76
|
+
listening.once('error', reject);
|
|
77
|
+
});
|
|
78
|
+
// The signing page rides on this same server, so a hosted deployment can offer browser
|
|
79
|
+
// signing without a second service: one platform port serves both /mcp and the page.
|
|
80
|
+
// Mounted last, so the routes above keep their paths — the relay only claims what is
|
|
81
|
+
// left, which is the static page at the root.
|
|
82
|
+
let walletUrl;
|
|
83
|
+
if (options.walletRelay) {
|
|
84
|
+
options.walletRelay.attach(server, (relayApp) => app.use(relayApp));
|
|
85
|
+
walletUrl = `${publicUrl.replace(/\/$/, '')}/#t=${options.walletRelay.token}`;
|
|
86
|
+
}
|
|
87
|
+
return { url: `${publicUrl.replace(/\/$/, '')}/mcp`, port: server.address().port, walletUrl };
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=http-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
2
|
+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
3
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
4
|
+
import { WalletRelay } from 'web3-wallet-relay';
|
|
5
|
+
import packageJson from '../package.json' with { type: 'json' };
|
|
6
|
+
import { initializeClientManager, SUPPORTED_CHAINS } from './client.js';
|
|
7
|
+
import { startHttpServer } from './http-server.js';
|
|
8
|
+
import { registerAllTools } from './tools/index.js';
|
|
9
|
+
import { parseCommandLineArgs } from './utils.js';
|
|
10
|
+
import { getWalletClient } from './wallet-client.js';
|
|
9
11
|
// Parse configuration
|
|
10
12
|
const config = parseCommandLineArgs();
|
|
11
13
|
// Show help if requested
|
|
@@ -23,6 +25,8 @@ OPTIONS:
|
|
|
23
25
|
--alchemy-api-key <key> Alchemy API key (for enhanced RPC)
|
|
24
26
|
--infura-api-key <key> Infura API key (for alternative RPC)
|
|
25
27
|
--hypersync-api-key <key> Hypersync API key (for fast event queries)
|
|
28
|
+
--walletconnect-project-id <id>
|
|
29
|
+
WalletConnect project id, to sign from a phone
|
|
26
30
|
--custom-rpc <json> Custom RPC URLs as JSON object
|
|
27
31
|
Example: '{"mainnet":"https://...", "base":"https://..."}'
|
|
28
32
|
|
|
@@ -31,11 +35,18 @@ ENVIRONMENT VARIABLES:
|
|
|
31
35
|
ALCHEMY_API_KEY Alternative to --alchemy-api-key
|
|
32
36
|
INFURA_API_KEY Alternative to --infura-api-key
|
|
33
37
|
HYPERSYNC_API_KEY Alternative to --hypersync-api-key
|
|
38
|
+
WALLETCONNECT_PROJECT_ID Alternative to --walletconnect-project-id
|
|
39
|
+
CUSTOM_RPC Alternative to --custom-rpc
|
|
40
|
+
MCP_HTTP_PORT Serve MCP over HTTP on this port instead of stdio
|
|
41
|
+
MCP_TOKEN Bearer token required by the HTTP transport
|
|
42
|
+
MCP_PUBLIC_URL Public URL of this server, advertised in OAuth metadata
|
|
43
|
+
UPSTASH_REDIS_REST_URL Keep WalletConnect sessions in Redis, not on disk
|
|
44
|
+
UPSTASH_REDIS_REST_TOKEN
|
|
34
45
|
WALLET_SERVER_URL URL of a hosted wallet relay (omit to run one locally)
|
|
35
46
|
WALLET_TOKEN Shared pairing token for the wallet relay
|
|
36
47
|
|
|
37
48
|
SUPPORTED CHAINS:
|
|
38
|
-
|
|
49
|
+
${SUPPORTED_CHAINS.join(', ')}
|
|
39
50
|
|
|
40
51
|
EXAMPLES:
|
|
41
52
|
# Use with npx (recommended)
|
|
@@ -58,32 +69,52 @@ For MCP client configuration, see the README.md file.
|
|
|
58
69
|
}
|
|
59
70
|
// Log configuration info
|
|
60
71
|
if (config.etherscanApiKey) {
|
|
61
|
-
console.error(
|
|
72
|
+
console.error('[MCP] Etherscan API key configured');
|
|
62
73
|
}
|
|
63
74
|
if (config.alchemyApiKey) {
|
|
64
|
-
console.error(
|
|
75
|
+
console.error('[MCP] Alchemy API key configured');
|
|
65
76
|
}
|
|
66
77
|
if (config.infuraApiKey) {
|
|
67
|
-
console.error(
|
|
78
|
+
console.error('[MCP] Infura API key configured');
|
|
79
|
+
}
|
|
80
|
+
if (config.walletConnectProjectId) {
|
|
81
|
+
console.error('[MCP] WalletConnect project id configured — phone signing available');
|
|
68
82
|
}
|
|
69
83
|
if (config.customRpcUrls) {
|
|
70
|
-
console.error(
|
|
84
|
+
console.error('[MCP] Custom RPC URLs:', Object.keys(config.customRpcUrls));
|
|
71
85
|
}
|
|
72
86
|
// Initialize client manager
|
|
73
87
|
initializeClientManager(config);
|
|
74
|
-
|
|
75
|
-
const server = new McpServer({
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
const
|
|
83
|
-
const
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
88
|
+
function createMcpServer() {
|
|
89
|
+
const server = new McpServer({
|
|
90
|
+
name: 'web3-tools-mcp',
|
|
91
|
+
version: packageJson.version
|
|
92
|
+
});
|
|
93
|
+
registerAllTools(server);
|
|
94
|
+
return server;
|
|
95
|
+
}
|
|
96
|
+
const httpMode = Boolean(process.env.MCP_HTTP_PORT);
|
|
97
|
+
const httpPort = Number(process.env.MCP_HTTP_PORT);
|
|
98
|
+
/**
|
|
99
|
+
* Hosted, the signing page rides on the same port as /mcp, so a browser wallet works from
|
|
100
|
+
* a deployment too — the platform gives one port and both fit on it.
|
|
101
|
+
*
|
|
102
|
+
* Its token is minted per boot rather than persisted. A hosted relay is reachable from
|
|
103
|
+
* anywhere, and the pairing URL is fetched through wallet_status, which already needs
|
|
104
|
+
* MCP_TOKEN — so nobody types this token, and a short-lived one costs nothing. Locally the
|
|
105
|
+
* token stays on disk, because several editor sessions have to find the same relay.
|
|
106
|
+
*/
|
|
107
|
+
const hostedRelay = httpMode
|
|
108
|
+
? new WalletRelay({ token: process.env.WALLET_TOKEN, publicUrl: process.env.MCP_PUBLIC_URL })
|
|
109
|
+
: undefined;
|
|
110
|
+
const wallet = getWalletClient(hostedRelay ? { port: httpPort, token: hostedRelay.token } : undefined);
|
|
111
|
+
// Hosted, the relay is attached to the HTTP server, so connect only once that is listening.
|
|
112
|
+
const walletReady = httpMode
|
|
113
|
+
? Promise.resolve()
|
|
114
|
+
: wallet.connect().catch((error) => {
|
|
115
|
+
console.error('[MCP] Wallet relay unavailable:', error.message);
|
|
116
|
+
console.error('[MCP] Transaction signing features will not be available');
|
|
117
|
+
});
|
|
87
118
|
// The wallet relay's listening socket keeps the event loop alive, so this process would
|
|
88
119
|
// outlive the client that spawned it and go on holding its port. Leave when the client does.
|
|
89
120
|
let shuttingDown = false;
|
|
@@ -95,21 +126,35 @@ async function shutdown(reason) {
|
|
|
95
126
|
await wallet.stop().catch(() => { });
|
|
96
127
|
process.exit(0);
|
|
97
128
|
}
|
|
98
|
-
process.stdin.on(
|
|
99
|
-
process.stdin.on(
|
|
100
|
-
process.on(
|
|
101
|
-
process.on(
|
|
129
|
+
process.stdin.on('end', () => shutdown('client disconnected'));
|
|
130
|
+
process.stdin.on('close', () => shutdown('client disconnected'));
|
|
131
|
+
process.on('SIGTERM', () => shutdown('SIGTERM'));
|
|
132
|
+
process.on('SIGINT', () => shutdown('SIGINT'));
|
|
102
133
|
// Start server
|
|
103
134
|
async function main() {
|
|
135
|
+
if (httpMode) {
|
|
136
|
+
const { url, walletUrl } = await startHttpServer({ createMcpServer, walletRelay: hostedRelay });
|
|
137
|
+
console.error(`Web3 Tools MCP Server listening on ${url}`);
|
|
138
|
+
// Join the relay now that it is listening, so browser signing is available here too.
|
|
139
|
+
await wallet.connect().catch((error) => {
|
|
140
|
+
console.error('[MCP] Could not join the wallet relay:', error.message);
|
|
141
|
+
});
|
|
142
|
+
if (walletUrl)
|
|
143
|
+
console.error(`Wallet interface available at ${walletUrl}`);
|
|
144
|
+
if (!config.walletConnectProjectId) {
|
|
145
|
+
console.error('[MCP] No WalletConnect project id — phone signing is unavailable on this server');
|
|
146
|
+
}
|
|
147
|
+
return;
|
|
148
|
+
}
|
|
104
149
|
const transport = new StdioServerTransport();
|
|
105
|
-
await
|
|
106
|
-
console.error(
|
|
150
|
+
await createMcpServer().connect(transport);
|
|
151
|
+
console.error('Web3 Tools MCP Server running on stdio');
|
|
107
152
|
// The relay may still be picking a free port, and its URL carries the pairing token.
|
|
108
153
|
await walletReady;
|
|
109
154
|
console.error(`Wallet interface available at ${wallet.getUrl()}`);
|
|
110
155
|
}
|
|
111
156
|
main().catch((error) => {
|
|
112
|
-
console.error(
|
|
157
|
+
console.error('Fatal error:', error);
|
|
113
158
|
process.exit(1);
|
|
114
159
|
});
|
|
115
160
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|