@gvnrdao/dh-lit-actions 0.0.309 → 0.0.310
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/dist/a_dev_address-probe-signer.meta.json +1 -1
- package/dist/a_dev_address-probe.meta.json +1 -1
- package/dist/a_dev_always-signer.meta.json +1 -1
- package/dist/a_dev_authorization-dummy-b.meta.json +1 -1
- package/dist/a_dev_authorization-dummy.meta.json +1 -1
- package/dist/a_dev_ethers-version-probe.meta.json +1 -1
- package/dist/a_dev_process-payment-sign-only.meta.json +1 -1
- package/dist/btc-address-balance.action.js +1 -1
- package/dist/btc-address-balance.hash +1 -1
- package/dist/btc-address-balance.meta.json +5 -5
- package/dist/btc-transaction-signer.action.js +1 -1
- package/dist/btc-transaction-signer.hash +1 -1
- package/dist/btc-transaction-signer.meta.json +5 -5
- package/dist/btc-utxo-invalidator.action.js +1 -1
- package/dist/btc-utxo-invalidator.hash +1 -1
- package/dist/btc-utxo-invalidator.meta.json +5 -5
- package/dist/btc-withdrawal.action.js +1 -1
- package/dist/btc-withdrawal.hash +1 -1
- package/dist/btc-withdrawal.meta.json +5 -5
- package/dist/encrypt-parameter.meta.json +1 -1
- package/dist/extend-position-validator.action.js +1 -1
- package/dist/extend-position-validator.hash +1 -1
- package/dist/extend-position-validator.meta.json +5 -5
- package/dist/liquidation-validator.action.js +1 -1
- package/dist/liquidation-validator.hash +1 -1
- package/dist/liquidation-validator.meta.json +5 -5
- package/dist/loan-vault-btc-balance.action.js +1 -1
- package/dist/loan-vault-btc-balance.hash +1 -1
- package/dist/loan-vault-btc-balance.meta.json +5 -5
- package/dist/pkp-validator.meta.json +1 -1
- package/dist/price-oracle.meta.json +1 -1
- package/dist/process-payment-validator.action.js +1 -1
- package/dist/process-payment-validator.hash +1 -1
- package/dist/process-payment-validator.meta.json +5 -5
- package/dist/stale-spend-recovery-validator.action.js +1 -1
- package/dist/stale-spend-recovery-validator.hash +1 -1
- package/dist/stale-spend-recovery-validator.meta.json +5 -5
- package/dist/ucd-mint-validator.action.js +1 -1
- package/dist/ucd-mint-validator.hash +1 -1
- package/dist/ucd-mint-validator.meta.json +5 -5
- package/package.json +1 -1
- package/pkg-dist/pkg-src/index.js +138 -65
- package/pkg-dist/pkg-src/index.js.map +4 -4
- package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts +7 -0
- package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts.map +1 -1
- package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts +5 -0
- package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts.map +1 -1
- package/pkg-dist/src/modules/bitcoin-balance-consensus.module.d.ts +23 -2
- package/pkg-dist/src/modules/bitcoin-balance-consensus.module.d.ts.map +1 -1
- package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts +8 -1
- package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts.map +1 -1
- package/pkg-dist/src/modules/bitcoin-provider-auth.d.ts +70 -0
- package/pkg-dist/src/modules/bitcoin-provider-auth.d.ts.map +1 -0
- package/pkg-dist/src/modules/bitcoin-provider-registry.d.ts.map +1 -1
|
@@ -28,6 +28,7 @@ export declare enum BitcoinNetwork {
|
|
|
28
28
|
/** Bitcoin regtest (local/testing) */
|
|
29
29
|
REGTEST = "regtest"
|
|
30
30
|
}
|
|
31
|
+
import type { ProviderAuth } from "../../modules/bitcoin-provider-auth";
|
|
31
32
|
/**
|
|
32
33
|
* Bitcoin provider configuration
|
|
33
34
|
*/
|
|
@@ -40,6 +41,12 @@ export interface BitcoinProviderConfig {
|
|
|
40
41
|
minConfirmations: number;
|
|
41
42
|
/** Human-readable provider name */
|
|
42
43
|
name: string;
|
|
44
|
+
/**
|
|
45
|
+
* Auth descriptor for the provider's Esplora API. Absent ⇒ no auth (public
|
|
46
|
+
* Esplora / regtest faucet). Populated from the decrypted registry blob for
|
|
47
|
+
* commercial providers (Maestro api-key, Blockstream Enterprise OAuth).
|
|
48
|
+
*/
|
|
49
|
+
auth?: ProviderAuth;
|
|
43
50
|
}
|
|
44
51
|
/**
|
|
45
52
|
* Mapping from EVM chain to Bitcoin network
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bitcoin-network-config.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin-network-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,+BAA+B;IAC/B,OAAO,YAAY;IAEnB,uBAAuB;IACvB,QAAQ,aAAa;IAErB,4BAA4B;IAC5B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sCAAsC;IACtC,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IAEZ,2CAA2C;IAC3C,OAAO,EAAE,cAAc,CAAC;IAExB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"bitcoin-network-config.d.ts","sourceRoot":"","sources":["../../../../src/constants/chunks/bitcoin-network-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,+BAA+B;IAC/B,OAAO,YAAY;IAEnB,uBAAuB;IACvB,QAAQ,aAAa;IAErB,4BAA4B;IAC5B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sBAAsB;IACtB,OAAO,YAAY;IAEnB,sCAAsC;IACtC,OAAO,YAAY;CACpB;AAED,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IAEZ,2CAA2C;IAC3C,OAAO,EAAE,cAAc,CAAC;IAExB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAIrE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,UAA4B,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAItD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,cAAc,EACd,qBAAqB,EAAE,CAqCxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAmBrD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,qBAAqB,CAgBvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAwBvB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAKR"}
|
|
@@ -27,6 +27,11 @@ export interface IBitcoinRPCHelper {
|
|
|
27
27
|
}
|
|
28
28
|
export interface BitcoinDataProviderConfig {
|
|
29
29
|
providerUrl: string;
|
|
30
|
+
/**
|
|
31
|
+
* Auth descriptor applied to every Esplora request against `providerUrl`.
|
|
32
|
+
* Absent ⇒ no auth headers (public Esplora / regtest faucet).
|
|
33
|
+
*/
|
|
34
|
+
auth?: import("../../modules/bitcoin-provider-auth").ProviderAuth;
|
|
30
35
|
fallbackProviders?: BitcoinDataSource[];
|
|
31
36
|
timeout?: number;
|
|
32
37
|
rpcHelper?: IBitcoinRPCHelper;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vault-balance.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance.i.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,IAAI,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,2BAA2B,EAAE,oBAAoB,CAAC;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}
|
|
1
|
+
{"version":3,"file":"vault-balance.i.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/chunks/vault-balance.i.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAC;IAClE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,IAAI,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,2BAA2B,EAAE,oBAAoB,CAAC;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}
|
|
@@ -3,8 +3,12 @@ import type { BitcoinProviderConfig } from "../constants";
|
|
|
3
3
|
export interface BalanceReader {
|
|
4
4
|
getBalance(address: string): Promise<bigint>;
|
|
5
5
|
}
|
|
6
|
-
/**
|
|
7
|
-
|
|
6
|
+
/**
|
|
7
|
+
* Factory for a balance reader from a provider config (so per-provider `auth` —
|
|
8
|
+
* Maestro api-key / Blockstream Enterprise OAuth — is applied to every
|
|
9
|
+
* cross-check request). Defaults to a real `BitcoinDataProvider`.
|
|
10
|
+
*/
|
|
11
|
+
export type BalanceReaderFactory = (config: BitcoinProviderConfig) => BalanceReader;
|
|
8
12
|
/**
|
|
9
13
|
* Multi-provider Bitcoin balance consensus (audit C-1/C-2 follow-up).
|
|
10
14
|
*
|
|
@@ -28,4 +32,21 @@ export type BalanceReaderFactory = (url: string) => BalanceReader;
|
|
|
28
32
|
* @returns the agreed balance (sats) when consensus ran, or `null` when skipped (< 2 providers).
|
|
29
33
|
*/
|
|
30
34
|
export declare function assertBitcoinBalanceConsensus(vaultAddress: string, providerConfigs: BitcoinProviderConfig[], timeoutMs?: number, makeReader?: BalanceReaderFactory): Promise<bigint | null>;
|
|
35
|
+
/**
|
|
36
|
+
* Read the confirmed balance of `vaultAddress` from EVERY provider concurrently
|
|
37
|
+
* and return the agreed value.
|
|
38
|
+
*
|
|
39
|
+
* Queries all providers in parallel (each call is independently AbortController-
|
|
40
|
+
* capped at `timeoutMs` inside `BitcoinDataProvider`, so wall-time ≈ the slowest
|
|
41
|
+
* single call, not the sum — this is what keeps multi-provider consensus inside
|
|
42
|
+
* the ~30s Lit Action budget). Fail-closed:
|
|
43
|
+
* - any provider request that rejects → throw, naming every failed provider;
|
|
44
|
+
* - with ≥2 providers, any balance that differs from the primary → throw,
|
|
45
|
+
* naming every mismatch (same C-1/C-2 guarantee as the sequential version).
|
|
46
|
+
*
|
|
47
|
+
* Returns the primary provider's balance. Requires ≥1 provider. Used directly by
|
|
48
|
+
* the balance/payment validators (which need the value even with one provider)
|
|
49
|
+
* and indirectly by {@link assertBitcoinBalanceConsensus}.
|
|
50
|
+
*/
|
|
51
|
+
export declare function readConsensusBalance(vaultAddress: string, providerConfigs: BitcoinProviderConfig[], timeoutMs?: number, makeReader?: BalanceReaderFactory): Promise<bigint>;
|
|
31
52
|
//# sourceMappingURL=bitcoin-balance-consensus.module.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bitcoin-balance-consensus.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-balance-consensus.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED
|
|
1
|
+
{"version":3,"file":"bitcoin-balance-consensus.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-balance-consensus.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,aAAa,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,qBAAqB,EAAE,EACxC,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,oBAAoB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,qBAAqB,EAAE,EACxC,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,oBAAoB,GAChC,OAAO,CAAC,MAAM,CAAC,CAoDjB"}
|
|
@@ -21,6 +21,13 @@ export declare class BitcoinDataProvider implements IBitcoinDataProvider {
|
|
|
21
21
|
private timeout;
|
|
22
22
|
private logger;
|
|
23
23
|
constructor(config: BitcoinDataProviderConfig);
|
|
24
|
+
/**
|
|
25
|
+
* Merge per-provider auth headers into a base header set. No-op for public
|
|
26
|
+
* Esplora / regtest faucet (no `auth`); attaches the `api-key` header for
|
|
27
|
+
* Maestro and performs a (memoized) OAuth exchange → `Bearer` for Blockstream
|
|
28
|
+
* Enterprise. Awaited at every fetch site so a single run shares one token.
|
|
29
|
+
*/
|
|
30
|
+
private withAuth;
|
|
24
31
|
/**
|
|
25
32
|
* Get current Bitcoin block height from provider
|
|
26
33
|
*/
|
|
@@ -62,7 +69,7 @@ export declare class BitcoinDataProvider implements IBitcoinDataProvider {
|
|
|
62
69
|
* Internal method to fetch UTXOs from a specific provider
|
|
63
70
|
*
|
|
64
71
|
* Supports standard Esplora API format:
|
|
65
|
-
* - Standard format: {providerUrl}/address/{address}/
|
|
72
|
+
* - Standard format: {providerUrl}/address/{address}/utxo
|
|
66
73
|
* - providerUrl must include full base path (e.g., "http://localhost:3002/api/esplora")
|
|
67
74
|
*/
|
|
68
75
|
private fetchUTXOsFromProvider;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bitcoin-data-provider.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-data-provider.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACR,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;
|
|
1
|
+
{"version":3,"file":"bitcoin-data-provider.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-data-provider.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACR,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AA2CpF;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA4C;gBAE9C,MAAM,EAAE,yBAAyB;IAO7C;;;;;OAKG;YACW,QAAQ;IAQtB;;OAEG;YACW,qBAAqB;IAwEnC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA0DhD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,iBAAiB;IAuB/B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,qBAAqB;IA4D7B;;;;;;OAMG;YACW,sBAAsB;IAyFpC;;;;;;;;;OASG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IAmDnB;;;;;;;;;;;;OAYG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuElD;;;;;;;;OAQG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA8G1D;;;;;;;;;;;OAWG;IACG,qBAAqB,CACzB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CA0DjH;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bitcoin provider auth (LIT Action side).
|
|
3
|
+
*
|
|
4
|
+
* The BitcoinProviderRegistry stores one encrypted blob per
|
|
5
|
+
* `(chainId, providerId)`. Historically that blob was a bare Esplora base URL.
|
|
6
|
+
* To support commercial providers that require credentials, the blob may now be
|
|
7
|
+
* a JSON object:
|
|
8
|
+
*
|
|
9
|
+
* { "provider": "esplora", "url": "https://blockstream.info/api" }
|
|
10
|
+
* { "provider": "maestro", "url": ".../v0/esplora", "apiKey": "..." }
|
|
11
|
+
* { "provider": "blockstream-enterprise", "url": ".../api",
|
|
12
|
+
* "clientId": "...", "clientSecret": "...", "tokenUrl"?: "..." }
|
|
13
|
+
*
|
|
14
|
+
* Secrets only ever materialize HERE, inside the running LIT Action (the blob is
|
|
15
|
+
* decrypted in-TEE). They are never in jsParams, on-chain plaintext, or the
|
|
16
|
+
* bundle.
|
|
17
|
+
*
|
|
18
|
+
* Backward compatibility: a legacy plaintext that is a bare URL (does not parse
|
|
19
|
+
* as a JSON object with a string `url`) is treated as
|
|
20
|
+
* `{ provider: "esplora", url }` — existing registry entries keep working
|
|
21
|
+
* without re-encryption.
|
|
22
|
+
*/
|
|
23
|
+
export type ProviderAuth = {
|
|
24
|
+
provider: "esplora";
|
|
25
|
+
} | {
|
|
26
|
+
provider: "maestro";
|
|
27
|
+
apiKey: string;
|
|
28
|
+
} | {
|
|
29
|
+
provider: "blockstream-enterprise";
|
|
30
|
+
clientId: string;
|
|
31
|
+
clientSecret: string;
|
|
32
|
+
tokenUrl?: string;
|
|
33
|
+
};
|
|
34
|
+
export interface ParsedProvider {
|
|
35
|
+
/** Esplora base URL (no trailing slash; paths are concatenated onto it). */
|
|
36
|
+
url: string;
|
|
37
|
+
/** Auth descriptor used to build request headers. */
|
|
38
|
+
auth: ProviderAuth;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Parse a decrypted provider plaintext into `{ url, auth }`.
|
|
42
|
+
*
|
|
43
|
+
* Accepts either a JSON object (when the trimmed plaintext starts with `{` and
|
|
44
|
+
* has a non-empty string `url`) or a legacy bare URL string. Throws on a JSON
|
|
45
|
+
* object that is missing `url` or required credentials for its provider type.
|
|
46
|
+
*/
|
|
47
|
+
export declare function parseProviderPlaintext(plaintext: string): ParsedProvider;
|
|
48
|
+
/**
|
|
49
|
+
* Resolve the HTTP headers to attach to an Esplora request for the given auth.
|
|
50
|
+
*
|
|
51
|
+
* - `esplora` (or undefined) → no auth headers
|
|
52
|
+
* - `maestro` → `{ "api-key": <key> }`
|
|
53
|
+
* - `blockstream-enterprise` → OAuth client-credentials exchange → `Authorization: Bearer <token>`
|
|
54
|
+
*/
|
|
55
|
+
export declare function authHeaders(auth: ProviderAuth | undefined, timeoutMs?: number): Promise<Record<string, string>>;
|
|
56
|
+
/**
|
|
57
|
+
* Auth-aware GET with an END-TO-END timeout budget.
|
|
58
|
+
*
|
|
59
|
+
* A request to an authenticated provider has two sequential network legs — the
|
|
60
|
+
* OAuth token exchange (Blockstream Enterprise) and the data request itself.
|
|
61
|
+
* Bounding each leg independently would let a single logical request run up to
|
|
62
|
+
* `2 × timeoutMs`, which can collide with Lit's ~30s execution limit. Instead we
|
|
63
|
+
* pin one deadline at the start: the token exchange is bounded by `timeoutMs`,
|
|
64
|
+
* and the data fetch only gets the REMAINING time. Total wall-time ≤ `timeoutMs`.
|
|
65
|
+
*
|
|
66
|
+
* Maestro/esplora have no token leg, so the data fetch gets ~the full budget.
|
|
67
|
+
* Returns the raw fetch Response; callers handle `.ok` / `.json()` as today.
|
|
68
|
+
*/
|
|
69
|
+
export declare function authedFetch(url: string, auth: ProviderAuth | undefined, timeoutMs: number): Promise<any>;
|
|
70
|
+
//# sourceMappingURL=bitcoin-provider-auth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bitcoin-provider-auth.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-provider-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GACvB;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IACE,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,YAAY,CAAC;CACpB;AAoBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CA4ExE;AAwED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAcjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAWd"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bitcoin-provider-registry.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"bitcoin-provider-registry.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA6ClD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,GAAG,EACb,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,GAAG,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EAAE,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgEjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAyBnC;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE;IACxD,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,GAAG,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAwClC"}
|