@totemsdk/chain-provider 0.1.3 → 0.1.4
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/README.md +63 -21
- package/dist/index.d.ts +2 -1
- package/dist/index.js +3 -4
- package/dist/providers/hosted.d.ts +35 -2
- package/dist/providers/hosted.js +162 -46
- package/dist/providers/lookup-client.d.ts +62 -0
- package/dist/providers/lookup-client.js +67 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -16,13 +16,14 @@ npm install @totemsdk/chain-provider
|
|
|
16
16
|
|
|
17
17
|
```typescript
|
|
18
18
|
interface ChainStateProvider {
|
|
19
|
-
getCoins(query:
|
|
20
|
-
getCoin(
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
getToken(
|
|
24
|
-
searchTokens(query:
|
|
25
|
-
|
|
19
|
+
getCoins(query: CoinsQuery): Promise<Coin[]>;
|
|
20
|
+
getCoin(coinId: string): Promise<Coin | null>;
|
|
21
|
+
getProof(coinId: string): Promise<MMRProof>;
|
|
22
|
+
getTip(): Promise<ChainTip>;
|
|
23
|
+
getToken(tokenId: string): Promise<TokenInfo>;
|
|
24
|
+
searchTokens(query: TokenSearchQuery): Promise<TokenInfo[]>;
|
|
25
|
+
getTokensByCreator(address: string): Promise<TokenInfo[]>;
|
|
26
|
+
broadcastTxPoW(txpowHex: string): Promise<BroadcastResult>;
|
|
26
27
|
}
|
|
27
28
|
```
|
|
28
29
|
|
|
@@ -32,7 +33,7 @@ interface ChainStateProvider {
|
|
|
32
33
|
|-------|------------|
|
|
33
34
|
| `HostedProvider` | Axia / MEG hosted API (requires project credentials) |
|
|
34
35
|
| `PureMinimaRpcProvider` | A local or self-hosted PureMinima node directly |
|
|
35
|
-
| `
|
|
36
|
+
| `LookupClientProvider` | A personal lookup node over Hyperswarm DHT (via `@totemsdk/lookup-client`) |
|
|
36
37
|
| `CompositeProvider` | Fans out across multiple providers with fallback logic |
|
|
37
38
|
|
|
38
39
|
Five other packages (`omnia`, `statechain`, `lookup-node`, `lookup-client`, `chain-provider` itself) accept `ChainStateProvider` — this is the pivot point between the upper SDK and chain data.
|
|
@@ -50,7 +51,7 @@ const provider = new HostedProvider({
|
|
|
50
51
|
projectSecret: process.env.AXIA_SECRET,
|
|
51
52
|
});
|
|
52
53
|
|
|
53
|
-
const tip
|
|
54
|
+
const tip = await provider.getTip();
|
|
54
55
|
const coins = await provider.getCoins({ address: 'Mx...' });
|
|
55
56
|
```
|
|
56
57
|
|
|
@@ -64,31 +65,72 @@ const provider = new PureMinimaRpcProvider({
|
|
|
64
65
|
});
|
|
65
66
|
```
|
|
66
67
|
|
|
68
|
+
### Personal lookup node (sovereign, zero-Axia-dependency)
|
|
69
|
+
|
|
70
|
+
Connect directly to your own lookup node over Hyperswarm DHT. No hosted infrastructure required.
|
|
71
|
+
|
|
72
|
+
```typescript
|
|
73
|
+
import { LookupClientProvider } from '@totemsdk/chain-provider';
|
|
74
|
+
import { connectLookupNode } from '@totemsdk/lookup-client';
|
|
75
|
+
|
|
76
|
+
// Connect to your personal lookup node
|
|
77
|
+
const client = await connectLookupNode({ hyperswarmTopic: 'deadbeef...' });
|
|
78
|
+
|
|
79
|
+
const provider = new LookupClientProvider(client);
|
|
80
|
+
|
|
81
|
+
const tip = await provider.getTip();
|
|
82
|
+
const coins = await provider.getCoins({ address: 'Mx...' });
|
|
83
|
+
|
|
84
|
+
// Clean up when done
|
|
85
|
+
client.disconnect();
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
`@totemsdk/lookup-client` is a peer dependency — install it separately:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
npm install @totemsdk/lookup-client
|
|
92
|
+
```
|
|
93
|
+
|
|
67
94
|
### Composite with fallback
|
|
68
95
|
|
|
96
|
+
Fan out across providers: try sovereign first, fall back to hosted on any error.
|
|
97
|
+
|
|
69
98
|
```typescript
|
|
70
|
-
import { CompositeProvider, HostedProvider,
|
|
99
|
+
import { CompositeProvider, HostedProvider, LookupClientProvider } from '@totemsdk/chain-provider';
|
|
100
|
+
import { connectLookupNode } from '@totemsdk/lookup-client';
|
|
71
101
|
|
|
72
|
-
const
|
|
73
|
-
new
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
102
|
+
const client = await connectLookupNode({ hyperswarmTopic: 'deadbeef...' });
|
|
103
|
+
const hosted = new HostedProvider({ baseUrl: 'https://api.axia.to', projectId: '...' });
|
|
104
|
+
|
|
105
|
+
const provider = new CompositeProvider(
|
|
106
|
+
new LookupClientProvider(client), // primary — sovereign, no Axia dependency
|
|
107
|
+
hosted, // fallback — hosted, always available
|
|
108
|
+
);
|
|
109
|
+
|
|
110
|
+
// Queries hit the lookup node first; fall back to hosted on error
|
|
111
|
+
const tip = await provider.getTip();
|
|
77
112
|
```
|
|
78
113
|
|
|
79
|
-
|
|
114
|
+
## LookupClientLike interface
|
|
115
|
+
|
|
116
|
+
`LookupClientProvider` accepts any object that satisfies the `LookupClientLike` structural interface exported from this package. This allows testing with a mock without importing `@totemsdk/lookup-client`:
|
|
80
117
|
|
|
81
118
|
```typescript
|
|
82
|
-
import {
|
|
119
|
+
import { LookupClientProvider } from '@totemsdk/chain-provider';
|
|
120
|
+
import type { LookupClientLike } from '@totemsdk/chain-provider';
|
|
83
121
|
|
|
84
|
-
const
|
|
85
|
-
|
|
86
|
-
|
|
122
|
+
const mockClient: LookupClientLike = {
|
|
123
|
+
getTip: async () => ({ block: 100, hash: '0x...' }),
|
|
124
|
+
getCoins: async () => [],
|
|
125
|
+
// ... etc
|
|
126
|
+
};
|
|
127
|
+
|
|
128
|
+
const provider = new LookupClientProvider(mockClient);
|
|
87
129
|
```
|
|
88
130
|
|
|
89
131
|
## See also
|
|
90
132
|
|
|
91
133
|
- [`@totemsdk/pureminima-rpc`](https://www.npmjs.com/package/@totemsdk/pureminima-rpc) — the RPC client used by `PureMinimaRpcProvider`
|
|
92
|
-
- [`@totemsdk/lookup-client`](https://www.npmjs.com/package/@totemsdk/lookup-client) —
|
|
134
|
+
- [`@totemsdk/lookup-client`](https://www.npmjs.com/package/@totemsdk/lookup-client) — connect to a personal lookup node over Hyperswarm DHT
|
|
93
135
|
- [`@totemsdk/node`](https://www.npmjs.com/package/@totemsdk/node) — Node.js `MinimaProvider`
|
|
94
136
|
- [`@totemsdk/omnia`](https://www.npmjs.com/package/@totemsdk/omnia) — uses `ChainStateProvider` for coin queries
|
package/dist/index.d.ts
CHANGED
|
@@ -2,5 +2,6 @@ export type { ChainStateProvider, CoinsQuery, Coin, MMRProof, ChainTip, TokenInf
|
|
|
2
2
|
export { HostedProvider } from './providers/hosted.js';
|
|
3
3
|
export type { HostedProviderConfig } from './providers/hosted.js';
|
|
4
4
|
export { PureMinimaRpcProvider } from './providers/pureminima.js';
|
|
5
|
-
export {
|
|
5
|
+
export { LookupClientProvider } from './providers/lookup-client.js';
|
|
6
|
+
export type { LookupClientLike } from './providers/lookup-client.js';
|
|
6
7
|
export { CompositeProvider } from './providers/composite.js';
|
package/dist/index.js
CHANGED
|
@@ -1,12 +1,11 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.CompositeProvider = exports.
|
|
3
|
+
exports.CompositeProvider = exports.LookupClientProvider = exports.PureMinimaRpcProvider = exports.HostedProvider = void 0;
|
|
4
4
|
var hosted_js_1 = require("./providers/hosted.js");
|
|
5
5
|
Object.defineProperty(exports, "HostedProvider", { enumerable: true, get: function () { return hosted_js_1.HostedProvider; } });
|
|
6
6
|
var pureminima_js_1 = require("./providers/pureminima.js");
|
|
7
7
|
Object.defineProperty(exports, "PureMinimaRpcProvider", { enumerable: true, get: function () { return pureminima_js_1.PureMinimaRpcProvider; } });
|
|
8
|
-
var
|
|
9
|
-
Object.defineProperty(exports, "
|
|
10
|
-
Object.defineProperty(exports, "LookupNodeNotImplementedError", { enumerable: true, get: function () { return lookup_js_1.LookupNodeNotImplementedError; } });
|
|
8
|
+
var lookup_client_js_1 = require("./providers/lookup-client.js");
|
|
9
|
+
Object.defineProperty(exports, "LookupClientProvider", { enumerable: true, get: function () { return lookup_client_js_1.LookupClientProvider; } });
|
|
11
10
|
var composite_js_1 = require("./providers/composite.js");
|
|
12
11
|
Object.defineProperty(exports, "CompositeProvider", { enumerable: true, get: function () { return composite_js_1.CompositeProvider; } });
|
|
@@ -1,6 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* HostedProvider — wraps
|
|
3
|
-
*
|
|
2
|
+
* HostedProvider — wraps Axia REST + RPC API endpoints.
|
|
3
|
+
*
|
|
4
|
+
* Endpoint map (all require x-api-key header):
|
|
5
|
+
* GET /v1/wallet/utxos/:address — coin list (totem-shared key)
|
|
6
|
+
* POST /v1/wallet/rpc — Minima RPC commands (totem-shared key)
|
|
7
|
+
* POST /api/meg/postminedtxn — broadcast mined TxPoW (no auth required)
|
|
8
|
+
*
|
|
9
|
+
* For dApp developers using custom project API keys the `/v1/wallet/*` routes
|
|
10
|
+
* require x-api-key: 'totem-shared'. Use the apiKey config option accordingly.
|
|
4
11
|
*/
|
|
5
12
|
import type { ChainStateProvider, CoinsQuery, Coin, MMRProof, ChainTip, TokenInfo, TokenSearchQuery, BroadcastResult } from '../types.js';
|
|
6
13
|
export interface HostedProviderConfig {
|
|
@@ -14,12 +21,38 @@ export declare class HostedProvider implements ChainStateProvider {
|
|
|
14
21
|
private readonly timeoutMs;
|
|
15
22
|
constructor(config: HostedProviderConfig);
|
|
16
23
|
private fetchJson;
|
|
24
|
+
/**
|
|
25
|
+
* Send a Minima command to POST /v1/wallet/rpc.
|
|
26
|
+
* Returns the `response` field of the Minima envelope.
|
|
27
|
+
*/
|
|
28
|
+
private rpc;
|
|
29
|
+
/**
|
|
30
|
+
* Get coins (UTXOs) for an address.
|
|
31
|
+
* Maps GET /v1/wallet/utxos/:address → Coin[].
|
|
32
|
+
*/
|
|
17
33
|
getCoins(query: CoinsQuery): Promise<Coin[]>;
|
|
18
34
|
getCoin(coinId: string): Promise<Coin | null>;
|
|
35
|
+
/**
|
|
36
|
+
* Get MMR proof for a coin via Minima `coinproof` RPC command.
|
|
37
|
+
*/
|
|
19
38
|
getProof(coinId: string): Promise<MMRProof>;
|
|
39
|
+
/**
|
|
40
|
+
* Get chain tip via Minima `status` RPC — parses response.chain.
|
|
41
|
+
*/
|
|
20
42
|
getTip(): Promise<ChainTip>;
|
|
43
|
+
/**
|
|
44
|
+
* Get token info via Minima `tokens tokenid:X` RPC command.
|
|
45
|
+
*/
|
|
21
46
|
getToken(tokenId: string): Promise<TokenInfo>;
|
|
47
|
+
/**
|
|
48
|
+
* Search tokens via Minima `tokens` RPC command, then filter client-side.
|
|
49
|
+
*/
|
|
22
50
|
searchTokens(query: TokenSearchQuery): Promise<TokenInfo[]>;
|
|
23
51
|
getTokensByCreator(address: string): Promise<TokenInfo[]>;
|
|
52
|
+
/**
|
|
53
|
+
* Broadcast a mined TxPoW hex.
|
|
54
|
+
* Uses POST /api/meg/postminedtxn (the correct Axia MEG broadcast bridge).
|
|
55
|
+
*/
|
|
24
56
|
broadcastTxPoW(txpowHex: string): Promise<BroadcastResult>;
|
|
57
|
+
private _mapToken;
|
|
25
58
|
}
|
package/dist/providers/hosted.js
CHANGED
|
@@ -1,7 +1,14 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
/**
|
|
3
|
-
* HostedProvider — wraps
|
|
4
|
-
*
|
|
3
|
+
* HostedProvider — wraps Axia REST + RPC API endpoints.
|
|
4
|
+
*
|
|
5
|
+
* Endpoint map (all require x-api-key header):
|
|
6
|
+
* GET /v1/wallet/utxos/:address — coin list (totem-shared key)
|
|
7
|
+
* POST /v1/wallet/rpc — Minima RPC commands (totem-shared key)
|
|
8
|
+
* POST /api/meg/postminedtxn — broadcast mined TxPoW (no auth required)
|
|
9
|
+
*
|
|
10
|
+
* For dApp developers using custom project API keys the `/v1/wallet/*` routes
|
|
11
|
+
* require x-api-key: 'totem-shared'. Use the apiKey config option accordingly.
|
|
5
12
|
*/
|
|
6
13
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
14
|
exports.HostedProvider = void 0;
|
|
@@ -33,76 +40,185 @@ class HostedProvider {
|
|
|
33
40
|
clearTimeout(timer);
|
|
34
41
|
}
|
|
35
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
* Send a Minima command to POST /v1/wallet/rpc.
|
|
45
|
+
* Returns the `response` field of the Minima envelope.
|
|
46
|
+
*/
|
|
47
|
+
async rpc(command) {
|
|
48
|
+
const controller = new AbortController();
|
|
49
|
+
const timer = setTimeout(() => controller.abort(), this.timeoutMs);
|
|
50
|
+
try {
|
|
51
|
+
const res = await fetch(`${this.baseUrl}/v1/wallet/rpc`, {
|
|
52
|
+
method: 'POST',
|
|
53
|
+
signal: controller.signal,
|
|
54
|
+
headers: {
|
|
55
|
+
'Content-Type': 'text/plain',
|
|
56
|
+
'x-api-key': this.apiKey,
|
|
57
|
+
},
|
|
58
|
+
body: command,
|
|
59
|
+
});
|
|
60
|
+
if (!res.ok)
|
|
61
|
+
throw new Error(`HostedProvider RPC "${command}" HTTP ${res.status}`);
|
|
62
|
+
const json = await res.json();
|
|
63
|
+
if (json.status === false)
|
|
64
|
+
throw new Error(`RPC "${command}" failed: ${json.error ?? 'unknown'}`);
|
|
65
|
+
return json.response;
|
|
66
|
+
}
|
|
67
|
+
finally {
|
|
68
|
+
clearTimeout(timer);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Get coins (UTXOs) for an address.
|
|
73
|
+
* Maps GET /v1/wallet/utxos/:address → Coin[].
|
|
74
|
+
*/
|
|
36
75
|
async getCoins(query) {
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
76
|
+
if (!query.address && !query.coinId)
|
|
77
|
+
return [];
|
|
78
|
+
if (query.coinId) {
|
|
79
|
+
const coin = await this.getCoin(query.coinId);
|
|
80
|
+
return coin ? [coin] : [];
|
|
81
|
+
}
|
|
82
|
+
const data = await this.fetchJson(`/v1/wallet/utxos/${encodeURIComponent(query.address)}`);
|
|
83
|
+
const raw = data.utxos ?? [];
|
|
84
|
+
return raw
|
|
85
|
+
.filter((u) => {
|
|
86
|
+
if (query.tokenId && u.tokenid !== query.tokenId)
|
|
87
|
+
return false;
|
|
88
|
+
if (query.sendable !== undefined && !!u.spent !== !query.sendable)
|
|
89
|
+
return false;
|
|
90
|
+
return true;
|
|
91
|
+
})
|
|
92
|
+
.map((u) => ({
|
|
93
|
+
coinid: u.coinid ?? u.id ?? '',
|
|
94
|
+
amount: String(u.amount ?? '0'),
|
|
95
|
+
address: u.address ?? query.address ?? '',
|
|
96
|
+
miniaddress: u.miniaddress,
|
|
97
|
+
tokenid: u.tokenid ?? '0x00',
|
|
98
|
+
token: u.token,
|
|
99
|
+
storestate: u.storestate,
|
|
100
|
+
state: u.state,
|
|
101
|
+
spent: !!u.spent,
|
|
102
|
+
mmrentry: u.mmrentry,
|
|
103
|
+
created: u.created,
|
|
104
|
+
}));
|
|
53
105
|
}
|
|
54
106
|
async getCoin(coinId) {
|
|
55
107
|
try {
|
|
56
|
-
const coins = await this.
|
|
57
|
-
|
|
108
|
+
const coins = await this.rpc(`coins coinid:${coinId}`);
|
|
109
|
+
const u = Array.isArray(coins) ? coins[0] : null;
|
|
110
|
+
if (!u)
|
|
111
|
+
return null;
|
|
112
|
+
return {
|
|
113
|
+
coinid: u.coinid ?? coinId,
|
|
114
|
+
amount: String(u.amount ?? '0'),
|
|
115
|
+
address: u.address ?? '',
|
|
116
|
+
miniaddress: u.miniaddress,
|
|
117
|
+
tokenid: u.tokenid ?? '0x00',
|
|
118
|
+
token: u.token,
|
|
119
|
+
storestate: u.storestate,
|
|
120
|
+
state: u.state,
|
|
121
|
+
spent: !!u.spent,
|
|
122
|
+
mmrentry: u.mmrentry,
|
|
123
|
+
created: u.created,
|
|
124
|
+
};
|
|
58
125
|
}
|
|
59
126
|
catch {
|
|
60
127
|
return null;
|
|
61
128
|
}
|
|
62
129
|
}
|
|
130
|
+
/**
|
|
131
|
+
* Get MMR proof for a coin via Minima `coinproof` RPC command.
|
|
132
|
+
*/
|
|
63
133
|
async getProof(coinId) {
|
|
64
|
-
|
|
134
|
+
const data = await this.rpc(`coinproof coinid:${coinId}`);
|
|
135
|
+
return { coinid: coinId, data };
|
|
65
136
|
}
|
|
137
|
+
/**
|
|
138
|
+
* Get chain tip via Minima `status` RPC — parses response.chain.
|
|
139
|
+
*/
|
|
66
140
|
async getTip() {
|
|
67
|
-
const
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
141
|
+
const data = await this.rpc('status');
|
|
142
|
+
const chain = data?.chain;
|
|
143
|
+
return {
|
|
144
|
+
block: chain?.block ?? 0,
|
|
145
|
+
hash: chain?.hash ?? '',
|
|
146
|
+
time: chain?.time,
|
|
147
|
+
};
|
|
72
148
|
}
|
|
149
|
+
/**
|
|
150
|
+
* Get token info via Minima `tokens tokenid:X` RPC command.
|
|
151
|
+
*/
|
|
73
152
|
async getToken(tokenId) {
|
|
74
|
-
|
|
153
|
+
const data = await this.rpc(`tokens tokenid:${tokenId}`);
|
|
154
|
+
const t = Array.isArray(data) ? data[0] : data;
|
|
155
|
+
if (!t)
|
|
156
|
+
throw new Error(`Token not found: ${tokenId}`);
|
|
157
|
+
return this._mapToken(t);
|
|
75
158
|
}
|
|
159
|
+
/**
|
|
160
|
+
* Search tokens via Minima `tokens` RPC command, then filter client-side.
|
|
161
|
+
*/
|
|
76
162
|
async searchTokens(query) {
|
|
77
|
-
const
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
163
|
+
const data = await this.rpc('tokens');
|
|
164
|
+
const all = Array.isArray(data) ? data : [];
|
|
165
|
+
return all
|
|
166
|
+
.filter((t) => {
|
|
167
|
+
if (t.tokenid === '0x00')
|
|
168
|
+
return false; // skip native Minima
|
|
169
|
+
if (query.name) {
|
|
170
|
+
const n = typeof t.name === 'object' ? (t.name?.name ?? '') : String(t.name ?? '');
|
|
171
|
+
if (!n.toLowerCase().includes(query.name.toLowerCase()))
|
|
172
|
+
return false;
|
|
173
|
+
}
|
|
174
|
+
return true;
|
|
175
|
+
})
|
|
176
|
+
.slice(query.offset ?? 0, query.limit ? (query.offset ?? 0) + query.limit : undefined)
|
|
177
|
+
.map(this._mapToken);
|
|
91
178
|
}
|
|
92
179
|
async getTokensByCreator(address) {
|
|
93
180
|
return this.searchTokens({ creatorAddress: address });
|
|
94
181
|
}
|
|
182
|
+
/**
|
|
183
|
+
* Broadcast a mined TxPoW hex.
|
|
184
|
+
* Uses POST /api/meg/postminedtxn (the correct Axia MEG broadcast bridge).
|
|
185
|
+
*/
|
|
95
186
|
async broadcastTxPoW(txpowHex) {
|
|
96
187
|
try {
|
|
97
|
-
const
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
188
|
+
const controller = new AbortController();
|
|
189
|
+
const timer = setTimeout(() => controller.abort(), this.timeoutMs);
|
|
190
|
+
let result;
|
|
191
|
+
try {
|
|
192
|
+
const res = await fetch(`${this.baseUrl}/api/meg/postminedtxn`, {
|
|
193
|
+
method: 'POST',
|
|
194
|
+
signal: controller.signal,
|
|
195
|
+
headers: { 'Content-Type': 'application/json' },
|
|
196
|
+
body: JSON.stringify({ data: txpowHex }),
|
|
197
|
+
});
|
|
198
|
+
result = await res.json();
|
|
199
|
+
if (!res.ok)
|
|
200
|
+
return { success: false, message: `HTTP ${res.status}: ${result?.error ?? ''}` };
|
|
201
|
+
}
|
|
202
|
+
finally {
|
|
203
|
+
clearTimeout(timer);
|
|
204
|
+
}
|
|
205
|
+
return { success: true, txpowid: result?.txpowid, message: result?.message };
|
|
102
206
|
}
|
|
103
207
|
catch (e) {
|
|
104
208
|
return { success: false, message: String(e) };
|
|
105
209
|
}
|
|
106
210
|
}
|
|
211
|
+
_mapToken(t) {
|
|
212
|
+
return {
|
|
213
|
+
tokenid: t.tokenid ?? '',
|
|
214
|
+
name: typeof t.name === 'object' ? t.name : { name: String(t.name ?? '') },
|
|
215
|
+
total: t.total,
|
|
216
|
+
confirmed: t.confirmed,
|
|
217
|
+
sendable: t.sendable,
|
|
218
|
+
coins: t.coins,
|
|
219
|
+
script: t.script,
|
|
220
|
+
description: t.description,
|
|
221
|
+
};
|
|
222
|
+
}
|
|
107
223
|
}
|
|
108
224
|
exports.HostedProvider = HostedProvider;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* LookupClientProvider — ChainStateProvider backed by a @totemsdk/lookup-client instance.
|
|
3
|
+
*
|
|
4
|
+
* Accepts any object that satisfies LookupClientLike (structural duck-typing),
|
|
5
|
+
* so @totemsdk/lookup-client remains a peer dependency: chain-provider does not
|
|
6
|
+
* bundle or import it at runtime. The caller is responsible for constructing the
|
|
7
|
+
* LookupClient and passing it in.
|
|
8
|
+
*
|
|
9
|
+
* @example
|
|
10
|
+
* ```ts
|
|
11
|
+
* import { connectLookupNode, LookupClientProvider } from '@totemsdk/lookup-client';
|
|
12
|
+
*
|
|
13
|
+
* const client = await connectLookupNode({ hyperswarmTopic: 'deadbeef...' });
|
|
14
|
+
* const provider = new LookupClientProvider(client);
|
|
15
|
+
*
|
|
16
|
+
* const tip = await provider.getTip();
|
|
17
|
+
* const coins = await provider.getCoins({ address: 'Mx...' });
|
|
18
|
+
* ```
|
|
19
|
+
*
|
|
20
|
+
* Use inside a CompositeProvider for sovereign-first / hosted-fallback:
|
|
21
|
+
*
|
|
22
|
+
* ```ts
|
|
23
|
+
* import { CompositeProvider, HostedProvider, LookupClientProvider } from '@totemsdk/chain-provider';
|
|
24
|
+
* import { connectLookupNode } from '@totemsdk/lookup-client';
|
|
25
|
+
*
|
|
26
|
+
* const client = await connectLookupNode({ hyperswarmTopic: 'abc...' });
|
|
27
|
+
* const fallback = new HostedProvider({ baseUrl: 'https://api.axia.to', projectId: '...' });
|
|
28
|
+
*
|
|
29
|
+
* const provider = new CompositeProvider(
|
|
30
|
+
* new LookupClientProvider(client),
|
|
31
|
+
* fallback,
|
|
32
|
+
* );
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
import type { BroadcastResult, ChainStateProvider, ChainTip, Coin, CoinsQuery, MMRProof, TokenInfo, TokenSearchQuery } from '../types.js';
|
|
36
|
+
/**
|
|
37
|
+
* Structural interface describing the subset of LookupClient methods that
|
|
38
|
+
* LookupClientProvider requires. Any object satisfying this interface can be
|
|
39
|
+
* passed in — most commonly a `LookupClient` from @totemsdk/lookup-client.
|
|
40
|
+
*/
|
|
41
|
+
export interface LookupClientLike {
|
|
42
|
+
getCoins(query: CoinsQuery): Promise<Coin[]>;
|
|
43
|
+
getCoin(coinId: string): Promise<Coin | null>;
|
|
44
|
+
getProof(coinId: string): Promise<MMRProof>;
|
|
45
|
+
getTip(): Promise<ChainTip>;
|
|
46
|
+
getToken(tokenId: string): Promise<TokenInfo>;
|
|
47
|
+
searchTokens(query: TokenSearchQuery): Promise<TokenInfo[]>;
|
|
48
|
+
getTokensByCreator(address: string): Promise<TokenInfo[]>;
|
|
49
|
+
broadcastTxPoW(txpowHex: string): Promise<BroadcastResult>;
|
|
50
|
+
}
|
|
51
|
+
export declare class LookupClientProvider implements ChainStateProvider {
|
|
52
|
+
private readonly _client;
|
|
53
|
+
constructor(_client: LookupClientLike);
|
|
54
|
+
getCoins(query: CoinsQuery): Promise<Coin[]>;
|
|
55
|
+
getCoin(coinId: string): Promise<Coin | null>;
|
|
56
|
+
getProof(coinId: string): Promise<MMRProof>;
|
|
57
|
+
getTip(): Promise<ChainTip>;
|
|
58
|
+
getToken(tokenId: string): Promise<TokenInfo>;
|
|
59
|
+
searchTokens(query: TokenSearchQuery): Promise<TokenInfo[]>;
|
|
60
|
+
getTokensByCreator(address: string): Promise<TokenInfo[]>;
|
|
61
|
+
broadcastTxPoW(txpowHex: string): Promise<BroadcastResult>;
|
|
62
|
+
}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* LookupClientProvider — ChainStateProvider backed by a @totemsdk/lookup-client instance.
|
|
4
|
+
*
|
|
5
|
+
* Accepts any object that satisfies LookupClientLike (structural duck-typing),
|
|
6
|
+
* so @totemsdk/lookup-client remains a peer dependency: chain-provider does not
|
|
7
|
+
* bundle or import it at runtime. The caller is responsible for constructing the
|
|
8
|
+
* LookupClient and passing it in.
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* ```ts
|
|
12
|
+
* import { connectLookupNode, LookupClientProvider } from '@totemsdk/lookup-client';
|
|
13
|
+
*
|
|
14
|
+
* const client = await connectLookupNode({ hyperswarmTopic: 'deadbeef...' });
|
|
15
|
+
* const provider = new LookupClientProvider(client);
|
|
16
|
+
*
|
|
17
|
+
* const tip = await provider.getTip();
|
|
18
|
+
* const coins = await provider.getCoins({ address: 'Mx...' });
|
|
19
|
+
* ```
|
|
20
|
+
*
|
|
21
|
+
* Use inside a CompositeProvider for sovereign-first / hosted-fallback:
|
|
22
|
+
*
|
|
23
|
+
* ```ts
|
|
24
|
+
* import { CompositeProvider, HostedProvider, LookupClientProvider } from '@totemsdk/chain-provider';
|
|
25
|
+
* import { connectLookupNode } from '@totemsdk/lookup-client';
|
|
26
|
+
*
|
|
27
|
+
* const client = await connectLookupNode({ hyperswarmTopic: 'abc...' });
|
|
28
|
+
* const fallback = new HostedProvider({ baseUrl: 'https://api.axia.to', projectId: '...' });
|
|
29
|
+
*
|
|
30
|
+
* const provider = new CompositeProvider(
|
|
31
|
+
* new LookupClientProvider(client),
|
|
32
|
+
* fallback,
|
|
33
|
+
* );
|
|
34
|
+
* ```
|
|
35
|
+
*/
|
|
36
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
37
|
+
exports.LookupClientProvider = void 0;
|
|
38
|
+
class LookupClientProvider {
|
|
39
|
+
constructor(_client) {
|
|
40
|
+
this._client = _client;
|
|
41
|
+
}
|
|
42
|
+
getCoins(query) {
|
|
43
|
+
return this._client.getCoins(query);
|
|
44
|
+
}
|
|
45
|
+
getCoin(coinId) {
|
|
46
|
+
return this._client.getCoin(coinId);
|
|
47
|
+
}
|
|
48
|
+
getProof(coinId) {
|
|
49
|
+
return this._client.getProof(coinId);
|
|
50
|
+
}
|
|
51
|
+
getTip() {
|
|
52
|
+
return this._client.getTip();
|
|
53
|
+
}
|
|
54
|
+
getToken(tokenId) {
|
|
55
|
+
return this._client.getToken(tokenId);
|
|
56
|
+
}
|
|
57
|
+
searchTokens(query) {
|
|
58
|
+
return this._client.searchTokens(query);
|
|
59
|
+
}
|
|
60
|
+
getTokensByCreator(address) {
|
|
61
|
+
return this._client.getTokensByCreator(address);
|
|
62
|
+
}
|
|
63
|
+
broadcastTxPoW(txpowHex) {
|
|
64
|
+
return this._client.broadcastTxPoW(txpowHex);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
exports.LookupClientProvider = LookupClientProvider;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@totemsdk/chain-provider",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Unified ChainStateProvider interface for Totem SDK — Hosted, PureMinima, Composite",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"LICENSE"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"@totemsdk/core": "1.0
|
|
20
|
+
"@totemsdk/core": "1.1.0",
|
|
21
21
|
"@totemsdk/pureminima-rpc": "0.1.3"
|
|
22
22
|
},
|
|
23
23
|
"devDependencies": {
|