@one-source/api-mcp 1.2.0 → 1.4.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/LICENSE +21 -21
- package/README.md +19 -21
- package/README.npm.md +19 -21
- package/README.repo.md +144 -153
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +5 -0
- package/dist/cli.js.map +1 -1
- package/dist/client.d.ts +1 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +0 -26
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/live/contract-info.d.ts.map +1 -1
- package/dist/tools/live/contract-info.js +0 -1
- package/dist/tools/live/contract-info.js.map +1 -1
- package/dist/tools/live/erc20-transfers.d.ts.map +1 -1
- package/dist/tools/live/erc20-transfers.js +0 -1
- package/dist/tools/live/erc20-transfers.js.map +1 -1
- package/dist/tools/live/events.d.ts.map +1 -1
- package/dist/tools/live/events.js +0 -1
- package/dist/tools/live/events.js.map +1 -1
- package/dist/tools/live/tx-details.d.ts.map +1 -1
- package/dist/tools/live/tx-details.js +0 -1
- package/dist/tools/live/tx-details.js.map +1 -1
- package/dist/x402.d.ts +8 -0
- package/dist/x402.d.ts.map +1 -0
- package/dist/x402.js +31 -0
- package/dist/x402.js.map +1 -0
- package/package.json +5 -2
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 BlockParty
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BlockParty
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# onesource-api-mcp
|
|
2
2
|
|
|
3
|
-
MCP server for OneSource blockchain data.
|
|
3
|
+
MCP server for OneSource blockchain data. 22 named tools for balances, NFTs, transactions, events, and live chain queries via x402 micropayments.
|
|
4
4
|
|
|
5
5
|
```
|
|
6
6
|
npx onesource-api-mcp
|
|
@@ -23,25 +23,7 @@ claude mcp add onesource-api -- npx onesource-api-mcp
|
|
|
23
23
|
}
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
## Tools (
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
### Indexed Data (12 tools)
|
|
30
|
-
|
|
31
|
-
| Tool | Description |
|
|
32
|
-
|------|-------------|
|
|
33
|
-
| `1s_address_txs` | Address transaction history |
|
|
34
|
-
| `1s_block` | Block details by number |
|
|
35
|
-
| `1s_contract_info` | Contract metadata |
|
|
36
|
-
| `1s_erc1155_balance` | ERC1155 token balance |
|
|
37
|
-
| `1s_erc20_balance` | ERC20 token balance |
|
|
38
|
-
| `1s_erc20_transfers` | ERC20 transfer history |
|
|
39
|
-
| `1s_events` | Event log search |
|
|
40
|
-
| `1s_nft_media` | NFT processed media URLs |
|
|
41
|
-
| `1s_nft_metadata` | NFT metadata and traits |
|
|
42
|
-
| `1s_nft_owner` | NFT current owner |
|
|
43
|
-
| `1s_tx_details` | Transaction with decoded events |
|
|
44
|
-
| `1s_wallet_nfts` | Wallet NFT portfolio |
|
|
26
|
+
## Tools (22)
|
|
45
27
|
|
|
46
28
|
|
|
47
29
|
### Live Chain Data (12 tools)
|
|
@@ -91,7 +73,23 @@ All tools accept an optional `network` parameter:
|
|
|
91
73
|
|
|
92
74
|
## Payment (x402)
|
|
93
75
|
|
|
94
|
-
Endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details.
|
|
76
|
+
Endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details.
|
|
77
|
+
|
|
78
|
+
**Automatic payments:** Set `X402_PRIVATE_KEY` to a funded EVM wallet key. The server will automatically sign and settle USDC payments for each tool call.
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
X402_PRIVATE_KEY=0x... npx onesource-api-mcp
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Without this key, 402 responses are returned as tool errors with a descriptive message.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
## Configuration
|
|
88
|
+
|
|
89
|
+
| Variable | Default | Description |
|
|
90
|
+
|----------|---------|-------------|
|
|
91
|
+
| `ONESOURCE_BASE_URL` | `https://skills.onesource.io` | Skills API endpoint |
|
|
92
|
+
| `X402_PRIVATE_KEY` | — | EVM private key (0x-prefixed hex) for automatic x402 USDC payments on Base |
|
|
95
93
|
|
|
96
94
|
|
|
97
95
|
## License
|
package/README.npm.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# onesource-api-mcp
|
|
2
2
|
|
|
3
|
-
MCP server for OneSource blockchain data.
|
|
3
|
+
MCP server for OneSource blockchain data. 22 named tools for balances, NFTs, transactions, events, and live chain queries via x402 micropayments.
|
|
4
4
|
|
|
5
5
|
```
|
|
6
6
|
npx onesource-api-mcp
|
|
@@ -23,25 +23,7 @@ claude mcp add onesource-api -- npx onesource-api-mcp
|
|
|
23
23
|
}
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
## Tools (
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
### Indexed Data (12 tools)
|
|
30
|
-
|
|
31
|
-
| Tool | Description |
|
|
32
|
-
|------|-------------|
|
|
33
|
-
| `1s_address_txs` | Address transaction history |
|
|
34
|
-
| `1s_block` | Block details by number |
|
|
35
|
-
| `1s_contract_info` | Contract metadata |
|
|
36
|
-
| `1s_erc1155_balance` | ERC1155 token balance |
|
|
37
|
-
| `1s_erc20_balance` | ERC20 token balance |
|
|
38
|
-
| `1s_erc20_transfers` | ERC20 transfer history |
|
|
39
|
-
| `1s_events` | Event log search |
|
|
40
|
-
| `1s_nft_media` | NFT processed media URLs |
|
|
41
|
-
| `1s_nft_metadata` | NFT metadata and traits |
|
|
42
|
-
| `1s_nft_owner` | NFT current owner |
|
|
43
|
-
| `1s_tx_details` | Transaction with decoded events |
|
|
44
|
-
| `1s_wallet_nfts` | Wallet NFT portfolio |
|
|
26
|
+
## Tools (22)
|
|
45
27
|
|
|
46
28
|
|
|
47
29
|
### Live Chain Data (12 tools)
|
|
@@ -91,7 +73,23 @@ All tools accept an optional `network` parameter:
|
|
|
91
73
|
|
|
92
74
|
## Payment (x402)
|
|
93
75
|
|
|
94
|
-
Endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details.
|
|
76
|
+
Endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details.
|
|
77
|
+
|
|
78
|
+
**Automatic payments:** Set `X402_PRIVATE_KEY` to a funded EVM wallet key. The server will automatically sign and settle USDC payments for each tool call.
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
X402_PRIVATE_KEY=0x... npx onesource-api-mcp
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Without this key, 402 responses are returned as tool errors with a descriptive message.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
## Configuration
|
|
88
|
+
|
|
89
|
+
| Variable | Default | Description |
|
|
90
|
+
|----------|---------|-------------|
|
|
91
|
+
| `ONESOURCE_BASE_URL` | `https://skills.onesource.io` | Skills API endpoint |
|
|
92
|
+
| `X402_PRIVATE_KEY` | — | EVM private key (0x-prefixed hex) for automatic x402 USDC payments on Base |
|
|
95
93
|
|
|
96
94
|
|
|
97
95
|
## License
|
package/README.repo.md
CHANGED
|
@@ -1,153 +1,144 @@
|
|
|
1
|
-
# onesource-api-mcp
|
|
2
|
-
|
|
3
|
-
MCP server for OneSource blockchain data.
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
npx onesource-api-mcp
|
|
7
|
-
```
|
|
8
|
-
|
|
9
|
-
## Install
|
|
10
|
-
|
|
11
|
-
```sh
|
|
12
|
-
# Claude Code
|
|
13
|
-
claude mcp add onesource-api -- npx onesource-api-mcp
|
|
14
|
-
|
|
15
|
-
# Claude Desktop / Cursor — add to MCP config:
|
|
16
|
-
{
|
|
17
|
-
"mcpServers": {
|
|
18
|
-
"onesource-api": {
|
|
19
|
-
"command": "npx",
|
|
20
|
-
"args": ["-y", "onesource-api-mcp"]
|
|
21
|
-
}
|
|
22
|
-
}
|
|
23
|
-
}
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Tools (
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
###
|
|
30
|
-
|
|
31
|
-
| Tool | Description |
|
|
32
|
-
|------|-------------|
|
|
33
|
-
| `
|
|
34
|
-
| `
|
|
35
|
-
| `
|
|
36
|
-
| `
|
|
37
|
-
| `
|
|
38
|
-
| `
|
|
39
|
-
| `
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
42
|
-
| `
|
|
43
|
-
| `
|
|
44
|
-
| `
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
###
|
|
48
|
-
|
|
49
|
-
| Tool | Description |
|
|
50
|
-
|------|-------------|
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
54
|
-
| `
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
|
68
|
-
|
|
69
|
-
| `
|
|
70
|
-
| `
|
|
71
|
-
| `
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
##
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
**
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
```sh
|
|
146
|
-
npm run build
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
This auto-regenerates the tool index and compiles. The new tool is immediately available in the MCP server.
|
|
150
|
-
|
|
151
|
-
## License
|
|
152
|
-
|
|
153
|
-
MIT
|
|
1
|
+
# onesource-api-mcp
|
|
2
|
+
|
|
3
|
+
MCP server for OneSource blockchain data. 22 named tools for balances, NFTs, transactions, events, and live chain queries via x402 micropayments.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
npx onesource-api-mcp
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
# Claude Code
|
|
13
|
+
claude mcp add onesource-api -- npx onesource-api-mcp
|
|
14
|
+
|
|
15
|
+
# Claude Desktop / Cursor — add to MCP config:
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"onesource-api": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "onesource-api-mcp"]
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Tools (22)
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
### Live Chain Data (12 tools)
|
|
30
|
+
|
|
31
|
+
| Tool | Description |
|
|
32
|
+
|------|-------------|
|
|
33
|
+
| `1s_allowance_live` | ERC20 allowance check |
|
|
34
|
+
| `1s_contract_info_live` | Contract type detection via ERC165 |
|
|
35
|
+
| `1s_erc1155_balance_live` | ERC1155 balance via RPC |
|
|
36
|
+
| `1s_erc20_balance_live` | ERC20 balance via balanceOf |
|
|
37
|
+
| `1s_erc20_transfers_live` | ERC20 Transfer logs via eth_getLogs |
|
|
38
|
+
| `1s_erc721_tokens_live` | ERC721 token enumeration |
|
|
39
|
+
| `1s_events_live` | Event logs via eth_getLogs |
|
|
40
|
+
| `1s_multi_balance_live` | ETH + multiple ERC20 balances |
|
|
41
|
+
| `1s_nft_metadata_live` | NFT metadata via tokenURI |
|
|
42
|
+
| `1s_nft_owner_live` | NFT owner via ownerOf |
|
|
43
|
+
| `1s_total_supply_live` | Token total supply |
|
|
44
|
+
| `1s_tx_details_live` | Transaction + receipt via RPC |
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
### Chain Utilities (10 tools) — RPC only
|
|
48
|
+
|
|
49
|
+
| Tool | Description |
|
|
50
|
+
|------|-------------|
|
|
51
|
+
| `1s_contract_code` | Contract bytecode |
|
|
52
|
+
| `1s_ens_resolve` | ENS name/address resolution |
|
|
53
|
+
| `1s_estimate_gas` | Gas estimation |
|
|
54
|
+
| `1s_network_info` | Chain ID, block number, gas price |
|
|
55
|
+
| `1s_nonce` | Transaction count |
|
|
56
|
+
| `1s_pending_block` | Pending block from mempool |
|
|
57
|
+
| `1s_proxy_detect` | Proxy contract detection |
|
|
58
|
+
| `1s_simulate_call` | Simulate eth_call |
|
|
59
|
+
| `1s_storage_read` | Read storage slot |
|
|
60
|
+
| `1s_tx_receipt` | Transaction receipt |
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
## Networks
|
|
64
|
+
|
|
65
|
+
All tools accept an optional `network` parameter:
|
|
66
|
+
|
|
67
|
+
| Network | Description |
|
|
68
|
+
|---------|-------------|
|
|
69
|
+
| `ethereum` | Ethereum mainnet (default) |
|
|
70
|
+
| `sepolia` | Ethereum Sepolia testnet |
|
|
71
|
+
| `avax` | Avalanche C-Chain |
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
## Payment (x402)
|
|
75
|
+
|
|
76
|
+
Endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details.
|
|
77
|
+
|
|
78
|
+
**Automatic payments:** Set `X402_PRIVATE_KEY` to a funded EVM wallet key. The server will automatically sign and settle USDC payments for each tool call.
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
X402_PRIVATE_KEY=0x... npx onesource-api-mcp
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Without this key, 402 responses are returned as tool errors with a descriptive message.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
## Configuration
|
|
88
|
+
|
|
89
|
+
| Variable | Default | Description |
|
|
90
|
+
|----------|---------|-------------|
|
|
91
|
+
| `ONESOURCE_BASE_URL` | `https://skills.onesource.io` | Skills API endpoint |
|
|
92
|
+
| `X402_PRIVATE_KEY` | — | EVM private key (0x-prefixed hex) for automatic x402 USDC payments on Base |
|
|
93
|
+
| `ONESOURCE_ANALYTICS` | `true` | Set `false` to disable analytics |
|
|
94
|
+
| `ONESOURCE_ANALYTICS_URL` | — | Dashboard endpoint for event ingestion |
|
|
95
|
+
| `ONESOURCE_ANALYTICS_KEY` | — | API key for the analytics dashboard |
|
|
96
|
+
|
|
97
|
+
## Transport Modes
|
|
98
|
+
|
|
99
|
+
```sh
|
|
100
|
+
# stdio (default — for MCP clients)
|
|
101
|
+
npx onesource-api-mcp
|
|
102
|
+
|
|
103
|
+
# HTTP (for testing or remote access)
|
|
104
|
+
npx onesource-api-mcp --http
|
|
105
|
+
npx onesource-api-mcp --http --port=8080
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
HTTP mode binds to `127.0.0.1` by default.
|
|
109
|
+
|
|
110
|
+
## Adding a New Tool
|
|
111
|
+
|
|
112
|
+
When a new SKILL.md is added to `skills/OneSource*/`, a corresponding MCP tool file needs to be created here.
|
|
113
|
+
|
|
114
|
+
**Step 1:** Create the SKILL.md in the skills repo (see the skills README for format).
|
|
115
|
+
|
|
116
|
+
**Step 2:** Scaffold the tool file:
|
|
117
|
+
|
|
118
|
+
```sh
|
|
119
|
+
cd mcp/
|
|
120
|
+
npm run new-tool
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
This prompts for:
|
|
124
|
+
- **Tool name** — `1s_` prefix, snake_case (e.g. `1s_token_info`)
|
|
125
|
+
- **Category** — `live` (direct RPC) or `chain` (RPC-only utility)
|
|
126
|
+
- **Description** — one-liner for the tool
|
|
127
|
+
- **Endpoint** — REST API path (e.g. `/api/chain/my-endpoint`)
|
|
128
|
+
- **Method** — GET or POST
|
|
129
|
+
|
|
130
|
+
It generates a tool file in `src/tools/{category}/` with TODO markers.
|
|
131
|
+
|
|
132
|
+
**Step 3:** Edit the generated file — fill in the Zod schema parameters and handler logic. Use the shared params from `src/types.ts` (`addressParam`, `txHashParam`, `tokenIdParam`, `hexDataParam`, `networkParam`, `limitParam`, `blockNumberParam`).
|
|
133
|
+
|
|
134
|
+
**Step 4:** Build:
|
|
135
|
+
|
|
136
|
+
```sh
|
|
137
|
+
npm run build
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
This auto-regenerates the tool index and compiles. The new tool is immediately available in the MCP server.
|
|
141
|
+
|
|
142
|
+
## License
|
|
143
|
+
|
|
144
|
+
MIT
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA0KA,OAAO,EAAE,CAAC"}
|
package/dist/cli.js
CHANGED
|
@@ -10,6 +10,11 @@
|
|
|
10
10
|
import { createMcpServer, VERSION } from './create-server.js';
|
|
11
11
|
import { createClientFromEnv } from './client.js';
|
|
12
12
|
import { createAnalytics } from './analytics.js';
|
|
13
|
+
import { setupX402 } from './x402.js';
|
|
14
|
+
const x402 = setupX402();
|
|
15
|
+
if (x402.enabled) {
|
|
16
|
+
console.error(`[onesource-api] x402 payments enabled (wallet: ${x402.address})`);
|
|
17
|
+
}
|
|
13
18
|
const args = process.argv.slice(2);
|
|
14
19
|
if (args.includes('--http')) {
|
|
15
20
|
// Parse --port=N or --port N
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/dist/client.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* HTTP client for the OneSource Skills REST API.
|
|
3
3
|
*
|
|
4
|
-
* All
|
|
4
|
+
* All 22 MCP tools delegate to this client, which handles:
|
|
5
5
|
* - Base URL configuration
|
|
6
6
|
* - x402 payment flow (402 → sign → retry)
|
|
7
7
|
* - Response envelope unwrapping
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA4B3C,eAAO,MAAM,QAAQ,EAAE,OAAO,EA0B7B,CAAC"}
|
package/dist/tools/index.js
CHANGED
|
@@ -1,16 +1,3 @@
|
|
|
1
|
-
// --- Indexed data (12 tools) ---
|
|
2
|
-
import { tool as addressTxs } from './indexed/address-txs.js';
|
|
3
|
-
import { tool as block } from './indexed/block.js';
|
|
4
|
-
import { tool as contractInfo } from './indexed/contract-info.js';
|
|
5
|
-
import { tool as erc1155Balance } from './indexed/erc1155-balance.js';
|
|
6
|
-
import { tool as erc20Balance } from './indexed/erc20-balance.js';
|
|
7
|
-
import { tool as erc20Transfers } from './indexed/erc20-transfers.js';
|
|
8
|
-
import { tool as events } from './indexed/events.js';
|
|
9
|
-
import { tool as nftMedia } from './indexed/nft-media.js';
|
|
10
|
-
import { tool as nftMetadata } from './indexed/nft-metadata.js';
|
|
11
|
-
import { tool as nftOwner } from './indexed/nft-owner.js';
|
|
12
|
-
import { tool as txDetails } from './indexed/tx-details.js';
|
|
13
|
-
import { tool as walletNfts } from './indexed/wallet-nfts.js';
|
|
14
1
|
// --- Live chain data (12 tools) ---
|
|
15
2
|
import { tool as allowanceLive } from './live/allowance.js';
|
|
16
3
|
import { tool as contractInfoLive } from './live/contract-info.js';
|
|
@@ -36,19 +23,6 @@ import { tool as simulateCall } from './chain/simulate-call.js';
|
|
|
36
23
|
import { tool as storageRead } from './chain/storage-read.js';
|
|
37
24
|
import { tool as txReceipt } from './chain/tx-receipt.js';
|
|
38
25
|
export const allTools = [
|
|
39
|
-
// Indexed data
|
|
40
|
-
addressTxs,
|
|
41
|
-
block,
|
|
42
|
-
contractInfo,
|
|
43
|
-
erc1155Balance,
|
|
44
|
-
erc20Balance,
|
|
45
|
-
erc20Transfers,
|
|
46
|
-
events,
|
|
47
|
-
nftMedia,
|
|
48
|
-
nftMetadata,
|
|
49
|
-
nftOwner,
|
|
50
|
-
txDetails,
|
|
51
|
-
walletNfts,
|
|
52
26
|
// Live chain data
|
|
53
27
|
allowanceLive,
|
|
54
28
|
contractInfoLive,
|
package/dist/tools/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAMA,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qCAAqC;AACrC,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAc;IACjC,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,UAAU;IACV,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,eAAe;IACf,aAAa;IAEb,kBAAkB;IAClB,YAAY;IACZ,UAAU;IACV,WAAW;IACX,WAAW;IACX,KAAK;IACL,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,WAAW;IACX,SAAS;CACV,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract-info.d.ts","sourceRoot":"","sources":["../../../src/tools/live/contract-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"contract-info.d.ts","sourceRoot":"","sources":["../../../src/tools/live/contract-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAgBlB,CAAC"}
|
|
@@ -2,7 +2,6 @@ import { networkParam, formatResponse, addressParam, safePath } from '../../type
|
|
|
2
2
|
export const tool = {
|
|
3
3
|
name: '1s_contract_info_live',
|
|
4
4
|
description: 'Detect contract type and supported interfaces via eth_getCode and ERC165 supportsInterface. ' +
|
|
5
|
-
'Use this for real-time standard detection; use 1s_contract_info for indexed metadata. ' +
|
|
6
5
|
'Returns detected standards (ERC20, ERC721, ERC1155, ERC165).',
|
|
7
6
|
category: 'live',
|
|
8
7
|
schema: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract-info.js","sourceRoot":"","sources":["../../../src/tools/live/contract-info.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,8FAA8F;QAC9F,
|
|
1
|
+
{"version":3,"file":"contract-info.js","sourceRoot":"","sources":["../../../src/tools/live/contract-info.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,8FAA8F;QAC9F,8DAA8D;IAChE,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE;QACN,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,uBAAuB,QAAQ,CAAC,KAAK,CAAC,OAAiB,CAAC,EAAE,EAAE;YACvF,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"erc20-transfers.d.ts","sourceRoot":"","sources":["../../../src/tools/live/erc20-transfers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"erc20-transfers.d.ts","sourceRoot":"","sources":["../../../src/tools/live/erc20-transfers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAuBlB,CAAC"}
|
|
@@ -2,7 +2,6 @@ import { networkParam, formatResponse, optionalAddressParam, hexDataParam } from
|
|
|
2
2
|
export const tool = {
|
|
3
3
|
name: '1s_erc20_transfers_live',
|
|
4
4
|
description: 'Query ERC20 Transfer event logs via eth_getLogs. ' +
|
|
5
|
-
'Use this for real-time transfer monitoring; use 1s_erc20_transfers for indexed transfer history. ' +
|
|
6
5
|
'Block params are hex-encoded.',
|
|
7
6
|
category: 'live',
|
|
8
7
|
schema: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"erc20-transfers.js","sourceRoot":"","sources":["../../../src/tools/live/erc20-transfers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElG,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,mDAAmD;QACnD
|
|
1
|
+
{"version":3,"file":"erc20-transfers.js","sourceRoot":"","sources":["../../../src/tools/live/erc20-transfers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElG,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,mDAAmD;QACnD,+BAA+B;IACjC,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE;QACN,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACpE,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC3E,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAChF,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC9D,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE;YACzD,KAAK,EAAE,KAAK,CAAC,KAA2B;YACxC,MAAM,EAAE,KAAK,CAAC,MAA4B;YAC1C,UAAU,EAAE,KAAK,CAAC,UAAgC;YAClD,QAAQ,EAAE,KAAK,CAAC,QAA8B;YAC9C,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/tools/live/events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/tools/live/events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAuBlB,CAAC"}
|
|
@@ -2,7 +2,6 @@ import { networkParam, formatResponse, optionalAddressParam, hexDataParam } from
|
|
|
2
2
|
export const tool = {
|
|
3
3
|
name: '1s_events_live',
|
|
4
4
|
description: 'Query raw event logs via eth_getLogs directly from the node. ' +
|
|
5
|
-
'Use this for real-time or unindexed events; use 1s_events for decoded, searchable indexed events. ' +
|
|
6
5
|
'Block params are hex-encoded (e.g. 0x1234).',
|
|
7
6
|
category: 'live',
|
|
8
7
|
schema: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/tools/live/events.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElG,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,+DAA+D;QAC/D,
|
|
1
|
+
{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/tools/live/events.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElG,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,+DAA+D;QAC/D,6CAA6C;IAC/C,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE;QACN,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACrE,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACpE,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAChF,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC9D,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE;YAChD,QAAQ,EAAE,KAAK,CAAC,QAA8B;YAC9C,KAAK,EAAE,KAAK,CAAC,KAA2B;YACxC,UAAU,EAAE,KAAK,CAAC,UAAgC;YAClD,QAAQ,EAAE,KAAK,CAAC,QAA8B;YAC9C,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tx-details.d.ts","sourceRoot":"","sources":["../../../src/tools/live/tx-details.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"tx-details.d.ts","sourceRoot":"","sources":["../../../src/tools/live/tx-details.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAgBlB,CAAC"}
|
|
@@ -2,7 +2,6 @@ import { networkParam, formatResponse, txHashParam, safePath } from '../../types
|
|
|
2
2
|
export const tool = {
|
|
3
3
|
name: '1s_tx_details_live',
|
|
4
4
|
description: 'Get full transaction data and receipt directly from the RPC node. ' +
|
|
5
|
-
'Use this for very recent or unindexed transactions; use 1s_tx_details for enriched indexed data. ' +
|
|
6
5
|
'Returns both transaction fields and receipt (status, gas used, logs).',
|
|
7
6
|
category: 'live',
|
|
8
7
|
schema: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tx-details.js","sourceRoot":"","sources":["../../../src/tools/live/tx-details.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,oEAAoE;QACpE,
|
|
1
|
+
{"version":3,"file":"tx-details.js","sourceRoot":"","sources":["../../../src/tools/live/tx-details.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,oEAAoE;QACpE,uEAAuE;IACzE,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,KAAK,CAAC,IAAc,CAAC,EAAE,EAAE;YAC9E,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}
|
package/dist/x402.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,SAAS,IAAI,eAAe,CAY3C;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,IAAI,IAAI,CAEhC"}
|
package/dist/x402.js
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* x402 payment setup.
|
|
3
|
+
*
|
|
4
|
+
* When X402_PRIVATE_KEY is set, replaces globalThis.fetch with a
|
|
5
|
+
* payment-aware wrapper that automatically handles HTTP 402 responses
|
|
6
|
+
* by signing USDC payments on Base via the x402 protocol.
|
|
7
|
+
*
|
|
8
|
+
* Must be called before any OneSourceClient instances are created.
|
|
9
|
+
*/
|
|
10
|
+
import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
|
|
11
|
+
import { registerExactEvmScheme } from '@x402/evm/exact/client';
|
|
12
|
+
import { privateKeyToAccount } from 'viem/accounts';
|
|
13
|
+
let _applied = false;
|
|
14
|
+
export function setupX402() {
|
|
15
|
+
const privateKey = process.env.X402_PRIVATE_KEY;
|
|
16
|
+
if (!privateKey)
|
|
17
|
+
return { enabled: false };
|
|
18
|
+
if (_applied)
|
|
19
|
+
return { enabled: true };
|
|
20
|
+
const signer = privateKeyToAccount(privateKey);
|
|
21
|
+
const client = new x402Client();
|
|
22
|
+
registerExactEvmScheme(client, { signer });
|
|
23
|
+
globalThis.fetch = wrapFetchWithPayment(fetch, client);
|
|
24
|
+
_applied = true;
|
|
25
|
+
return { enabled: true, address: signer.address };
|
|
26
|
+
}
|
|
27
|
+
/** @internal -- for test teardown only */
|
|
28
|
+
export function resetX402() {
|
|
29
|
+
_applied = false;
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=x402.js.map
|
package/dist/x402.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"x402.js","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,SAAS;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAA2B,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,sBAAsB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvD,QAAQ,GAAG,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,SAAS;IACvB,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@one-source/api-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "MCP server for OneSource blockchain data —
|
|
5
|
+
"description": "MCP server for OneSource blockchain data — 22 named tools for balances, NFTs, transactions, events, and live chain queries via x402",
|
|
6
6
|
"bin": {
|
|
7
7
|
"onesource-api-mcp": "./dist/cli.js"
|
|
8
8
|
},
|
|
@@ -61,6 +61,9 @@
|
|
|
61
61
|
},
|
|
62
62
|
"dependencies": {
|
|
63
63
|
"@modelcontextprotocol/sdk": "^1.27.1",
|
|
64
|
+
"@x402/evm": "^2.0.0",
|
|
65
|
+
"@x402/fetch": "^2.0.0",
|
|
66
|
+
"viem": "^2.0.0",
|
|
64
67
|
"zod": "^3.24.0"
|
|
65
68
|
},
|
|
66
69
|
"devDependencies": {
|