@gvnrdao/dh-lit-actions 0.0.308 → 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.
Files changed (54) hide show
  1. package/dist/a_dev_address-probe-signer.meta.json +1 -1
  2. package/dist/a_dev_address-probe.meta.json +1 -1
  3. package/dist/a_dev_always-signer.meta.json +1 -1
  4. package/dist/a_dev_authorization-dummy-b.meta.json +1 -1
  5. package/dist/a_dev_authorization-dummy.meta.json +1 -1
  6. package/dist/a_dev_ethers-version-probe.meta.json +1 -1
  7. package/dist/a_dev_process-payment-sign-only.meta.json +1 -1
  8. package/dist/btc-address-balance.action.js +1 -1
  9. package/dist/btc-address-balance.hash +1 -1
  10. package/dist/btc-address-balance.meta.json +5 -5
  11. package/dist/btc-transaction-signer.action.js +1 -1
  12. package/dist/btc-transaction-signer.hash +1 -1
  13. package/dist/btc-transaction-signer.meta.json +5 -5
  14. package/dist/btc-utxo-invalidator.action.js +1 -1
  15. package/dist/btc-utxo-invalidator.hash +1 -1
  16. package/dist/btc-utxo-invalidator.meta.json +5 -5
  17. package/dist/btc-withdrawal.action.js +1 -1
  18. package/dist/btc-withdrawal.hash +1 -1
  19. package/dist/btc-withdrawal.meta.json +5 -5
  20. package/dist/encrypt-parameter.meta.json +1 -1
  21. package/dist/extend-position-validator.action.js +1 -1
  22. package/dist/extend-position-validator.hash +1 -1
  23. package/dist/extend-position-validator.meta.json +5 -5
  24. package/dist/liquidation-validator.action.js +1 -1
  25. package/dist/liquidation-validator.hash +1 -1
  26. package/dist/liquidation-validator.meta.json +5 -5
  27. package/dist/loan-vault-btc-balance.action.js +1 -1
  28. package/dist/loan-vault-btc-balance.hash +1 -1
  29. package/dist/loan-vault-btc-balance.meta.json +5 -5
  30. package/dist/pkp-validator.meta.json +1 -1
  31. package/dist/price-oracle.meta.json +1 -1
  32. package/dist/process-payment-validator.action.js +1 -1
  33. package/dist/process-payment-validator.hash +1 -1
  34. package/dist/process-payment-validator.meta.json +5 -5
  35. package/dist/stale-spend-recovery-validator.action.js +1 -1
  36. package/dist/stale-spend-recovery-validator.hash +1 -1
  37. package/dist/stale-spend-recovery-validator.meta.json +5 -5
  38. package/dist/ucd-mint-validator.action.js +1 -1
  39. package/dist/ucd-mint-validator.hash +1 -1
  40. package/dist/ucd-mint-validator.meta.json +5 -5
  41. package/package.json +1 -1
  42. package/pkg-dist/pkg-src/index.js +150 -77
  43. package/pkg-dist/pkg-src/index.js.map +4 -4
  44. package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts +7 -0
  45. package/pkg-dist/src/constants/chunks/bitcoin-network-config.d.ts.map +1 -1
  46. package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts +5 -0
  47. package/pkg-dist/src/interfaces/chunks/vault-balance.i.d.ts.map +1 -1
  48. package/pkg-dist/src/modules/bitcoin-balance-consensus.module.d.ts +23 -2
  49. package/pkg-dist/src/modules/bitcoin-balance-consensus.module.d.ts.map +1 -1
  50. package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts +8 -1
  51. package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts.map +1 -1
  52. package/pkg-dist/src/modules/bitcoin-provider-auth.d.ts +70 -0
  53. package/pkg-dist/src/modules/bitcoin-provider-auth.d.ts.map +1 -0
  54. 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;CACd;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"}
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
- /** Factory for a balance reader from a provider URL. Defaults to a real `BitcoinDataProvider`. */
7
- export type BalanceReaderFactory = (url: string) => BalanceReader;
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,kGAAkG;AAClG,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;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,CAoCxB"}
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}/utxos
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;AA0CpF;;;;;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;;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;IAuFpC;;;;;;;;;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;IA6G1D;;;;;;;;;;;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;CAyDjH;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}
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;AA4ClD,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,CAWxB;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,CAmClC"}
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"}