@pushchain/core 6.0.3 → 6.0.5

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 (22) hide show
  1. package/package.json +1 -1
  2. package/src/lib/orchestrator/data-utils.d.ts +5 -0
  3. package/src/lib/orchestrator/data-utils.js +13 -0
  4. package/src/lib/orchestrator/internals/cascade.js +129 -91
  5. package/src/lib/orchestrator/internals/context.js +2 -3
  6. package/src/lib/orchestrator/internals/execute-funds-only.js +23 -3
  7. package/src/lib/orchestrator/internals/preflight.d.ts +3 -2
  8. package/src/lib/orchestrator/internals/preflight.js +3 -2
  9. package/src/lib/orchestrator/internals/progress-route-hooks.d.ts +0 -1
  10. package/src/lib/orchestrator/internals/progress-route-hooks.js +0 -2
  11. package/src/lib/orchestrator/internals/response-builder.js +1 -33
  12. package/src/lib/orchestrator/internals/route-handlers.js +62 -48
  13. package/src/lib/orchestrator/internals/tx-transformer.js +7 -11
  14. package/src/lib/orchestrator/orchestrator.js +5 -4
  15. package/src/lib/orchestrator/orchestrator.types.d.ts +12 -0
  16. package/src/lib/orchestrator/payload-builders.d.ts +2 -1
  17. package/src/lib/orchestrator/payload-builders.js +22 -14
  18. package/src/lib/orchestrator/route-detector.js +2 -1
  19. package/src/lib/progress-hook/progress-hook.js +26 -12
  20. package/src/lib/progress-hook/progress-hook.types.d.ts +7 -5
  21. package/src/lib/progress-hook/progress-hook.types.js +4 -3
  22. package/src/lib/push-chain/push-chain.d.ts +2 -0
package/src/lib/progress-hook/progress-hook.types.d.ts CHANGED
@@ -40,7 +40,8 @@ export declare enum PROGRESS_HOOK {
40
40
  SEND_TX_107 = "SEND-TX-107",
41
41
  SEND_TX_199_01 = "SEND-TX-199-01",// R1 terminal Push success
42
42
  SEND_TX_199_02 = "SEND-TX-199-02",// R1 terminal Push failure
43
- SEND_TX_199_99_99 = "SEND-TX-199-99-99",// R3 intermediate Push success
43
+ SEND_TX_199_03 = "SEND-TX-199-03",
44
+ SEND_TX_199_99 = "SEND-TX-199-99",// R1 multihop intermediate Push success
44
45
  SEND_TX_201 = "SEND-TX-201",
45
46
  SEND_TX_202_01 = "SEND-TX-202-01",
46
47
  SEND_TX_202_02 = "SEND-TX-202-02",
@@ -68,7 +69,7 @@ export declare enum PROGRESS_HOOK {
68
69
  SEND_TX_303_03_01 = "SEND-TX-303-03-01",// Sizer: Case A (< $1, padded)
69
70
  SEND_TX_303_03_02 = "SEND-TX-303-03-02",// Sizer: Case B ($1–$10, happy path)
70
71
  SEND_TX_303_03_03 = "SEND-TX-303-03-03",// Sizer: Case C (> $10, split + overflow bridge)
71
- SEND_TX_303_04 = "SEND-TX-303-04",// R3 pre-flight balance check (INFO/WARNING/ERROR per enforceGasCheck)
72
+ SEND_TX_303_04 = "SEND-TX-303-04",// R3 pre-flight balance check (INFO when sufficient, WARNING when short)
72
73
  SEND_TX_303_05 = "SEND-TX-303-05",// R3 pre-flight FAILED (ERROR, terminal precursor before 399-02)
73
74
  SEND_TX_303_06 = "SEND-TX-303-06",// R3 SVM warn-threshold tripped (INFO, no action)
74
75
  SEND_TX_304_01 = "SEND-TX-304-01",
@@ -84,10 +85,11 @@ export declare enum PROGRESS_HOOK {
84
85
  SEND_TX_399_01 = "SEND-TX-399-01",
85
86
  SEND_TX_399_02 = "SEND-TX-399-02",
86
87
  SEND_TX_399_03 = "SEND-TX-399-03",
88
+ SEND_TX_399_99 = "SEND-TX-399-99",// R3 multihop intermediate round-trip success
87
89
  SEND_TX_001 = "SEND-TX-001",
88
90
  SEND_TX_002_01 = "SEND-TX-002-01",
89
91
  SEND_TX_002_99_99 = "SEND-TX-002-99-99",
90
- SEND_TX_003_03 = "SEND-TX-003-03",// Cascade pre-flight balance check (INFO/WARNING/ERROR per enforceGasCheck)
92
+ SEND_TX_003_03 = "SEND-TX-003-03",// Cascade pre-flight balance check (INFO when sufficient, WARNING when short)
91
93
  SEND_TX_003_04 = "SEND-TX-003-04",// Cascade pre-flight FAILED (ERROR, terminal precursor before 999-02)
92
94
  SEND_TX_003_05 = "SEND-TX-003-05",// Cascade SVM warn-threshold tripped (INFO, no action)
93
95
  SEND_TX_999_01 = "SEND-TX-999-01",
@@ -100,9 +102,9 @@ export declare enum PROGRESS_HOOK {
100
102
  UEA_MIG_9902 = "UEA-MIG-9902",
101
103
  UEA_MIG_9903 = "UEA-MIG-9903"
102
104
  }
103
- export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_103_03 | PROGRESS_HOOK.SEND_TX_103_03_01 | PROGRESS_HOOK.SEND_TX_103_03_02 | PROGRESS_HOOK.SEND_TX_103_03_03 | PROGRESS_HOOK.SEND_TX_103_03_04 | PROGRESS_HOOK.SEND_TX_104_01 | PROGRESS_HOOK.SEND_TX_104_02 | PROGRESS_HOOK.SEND_TX_104_03 | PROGRESS_HOOK.SEND_TX_104_04 | PROGRESS_HOOK.SEND_TX_105_01 | PROGRESS_HOOK.SEND_TX_105_02 | PROGRESS_HOOK.SEND_TX_106_01 | PROGRESS_HOOK.SEND_TX_106_02 | PROGRESS_HOOK.SEND_TX_106_03 | PROGRESS_HOOK.SEND_TX_106_03_01 | PROGRESS_HOOK.SEND_TX_106_03_02 | PROGRESS_HOOK.SEND_TX_106_04 | PROGRESS_HOOK.SEND_TX_106_05 | PROGRESS_HOOK.SEND_TX_106_06 | PROGRESS_HOOK.SEND_TX_107 | PROGRESS_HOOK.SEND_TX_199_01 | PROGRESS_HOOK.SEND_TX_199_02;
105
+ export type PROGRESS_HOOK_R1 = PROGRESS_HOOK.SEND_TX_101 | PROGRESS_HOOK.SEND_TX_102_01 | PROGRESS_HOOK.SEND_TX_103_01 | PROGRESS_HOOK.SEND_TX_103_02 | PROGRESS_HOOK.SEND_TX_103_03 | PROGRESS_HOOK.SEND_TX_103_03_01 | PROGRESS_HOOK.SEND_TX_103_03_02 | PROGRESS_HOOK.SEND_TX_103_03_03 | PROGRESS_HOOK.SEND_TX_103_03_04 | PROGRESS_HOOK.SEND_TX_104_01 | PROGRESS_HOOK.SEND_TX_104_02 | PROGRESS_HOOK.SEND_TX_104_03 | PROGRESS_HOOK.SEND_TX_104_04 | PROGRESS_HOOK.SEND_TX_105_01 | PROGRESS_HOOK.SEND_TX_105_02 | PROGRESS_HOOK.SEND_TX_106_01 | PROGRESS_HOOK.SEND_TX_106_02 | PROGRESS_HOOK.SEND_TX_106_03 | PROGRESS_HOOK.SEND_TX_106_03_01 | PROGRESS_HOOK.SEND_TX_106_03_02 | PROGRESS_HOOK.SEND_TX_106_04 | PROGRESS_HOOK.SEND_TX_106_05 | PROGRESS_HOOK.SEND_TX_106_06 | PROGRESS_HOOK.SEND_TX_107 | PROGRESS_HOOK.SEND_TX_199_01 | PROGRESS_HOOK.SEND_TX_199_02 | PROGRESS_HOOK.SEND_TX_199_03 | PROGRESS_HOOK.SEND_TX_199_99;
104
106
  export type PROGRESS_HOOK_R2 = PROGRESS_HOOK.SEND_TX_201 | PROGRESS_HOOK.SEND_TX_202_01 | PROGRESS_HOOK.SEND_TX_202_02 | PROGRESS_HOOK.SEND_TX_203_01 | PROGRESS_HOOK.SEND_TX_203_02 | PROGRESS_HOOK.SEND_TX_203_03 | PROGRESS_HOOK.SEND_TX_203_04 | PROGRESS_HOOK.SEND_TX_203_05 | PROGRESS_HOOK.SEND_TX_204_01 | PROGRESS_HOOK.SEND_TX_204_02 | PROGRESS_HOOK.SEND_TX_204_03 | PROGRESS_HOOK.SEND_TX_204_04 | PROGRESS_HOOK.SEND_TX_207 | PROGRESS_HOOK.SEND_TX_209_01 | PROGRESS_HOOK.SEND_TX_209_02 | PROGRESS_HOOK.SEND_TX_299_01 | PROGRESS_HOOK.SEND_TX_299_02 | PROGRESS_HOOK.SEND_TX_299_03 | PROGRESS_HOOK.SEND_TX_299_99;
105
- export type PROGRESS_HOOK_R3 = PROGRESS_HOOK.SEND_TX_199_99_99 | PROGRESS_HOOK.SEND_TX_301 | PROGRESS_HOOK.SEND_TX_302_01 | PROGRESS_HOOK.SEND_TX_302_02 | PROGRESS_HOOK.SEND_TX_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_303_03_01 | PROGRESS_HOOK.SEND_TX_303_03_02 | PROGRESS_HOOK.SEND_TX_303_03_03 | PROGRESS_HOOK.SEND_TX_303_04 | PROGRESS_HOOK.SEND_TX_303_05 | PROGRESS_HOOK.SEND_TX_303_06 | PROGRESS_HOOK.SEND_TX_304_01 | PROGRESS_HOOK.SEND_TX_304_02 | PROGRESS_HOOK.SEND_TX_304_03 | PROGRESS_HOOK.SEND_TX_304_04 | PROGRESS_HOOK.SEND_TX_307 | PROGRESS_HOOK.SEND_TX_309_01 | PROGRESS_HOOK.SEND_TX_309_02 | PROGRESS_HOOK.SEND_TX_309_03 | PROGRESS_HOOK.SEND_TX_310_01 | PROGRESS_HOOK.SEND_TX_310_02 | PROGRESS_HOOK.SEND_TX_399_01 | PROGRESS_HOOK.SEND_TX_399_02 | PROGRESS_HOOK.SEND_TX_399_03;
107
+ export type PROGRESS_HOOK_R3 = PROGRESS_HOOK.SEND_TX_301 | PROGRESS_HOOK.SEND_TX_302_01 | PROGRESS_HOOK.SEND_TX_302_02 | PROGRESS_HOOK.SEND_TX_303_01 | PROGRESS_HOOK.SEND_TX_303_02 | PROGRESS_HOOK.SEND_TX_303_03_01 | PROGRESS_HOOK.SEND_TX_303_03_02 | PROGRESS_HOOK.SEND_TX_303_03_03 | PROGRESS_HOOK.SEND_TX_303_04 | PROGRESS_HOOK.SEND_TX_303_05 | PROGRESS_HOOK.SEND_TX_303_06 | PROGRESS_HOOK.SEND_TX_304_01 | PROGRESS_HOOK.SEND_TX_304_02 | PROGRESS_HOOK.SEND_TX_304_03 | PROGRESS_HOOK.SEND_TX_304_04 | PROGRESS_HOOK.SEND_TX_307 | PROGRESS_HOOK.SEND_TX_309_01 | PROGRESS_HOOK.SEND_TX_309_02 | PROGRESS_HOOK.SEND_TX_309_03 | PROGRESS_HOOK.SEND_TX_310_01 | PROGRESS_HOOK.SEND_TX_310_02 | PROGRESS_HOOK.SEND_TX_399_01 | PROGRESS_HOOK.SEND_TX_399_02 | PROGRESS_HOOK.SEND_TX_399_03 | PROGRESS_HOOK.SEND_TX_399_99;
106
108
  export type PROGRESS_HOOK_MULTICHAIN = PROGRESS_HOOK.SEND_TX_001 | PROGRESS_HOOK.SEND_TX_002_01 | PROGRESS_HOOK.SEND_TX_002_99_99 | PROGRESS_HOOK.SEND_TX_003_03 | PROGRESS_HOOK.SEND_TX_003_04 | PROGRESS_HOOK.SEND_TX_003_05 | PROGRESS_HOOK.SEND_TX_999_01 | PROGRESS_HOOK.SEND_TX_999_02 | PROGRESS_HOOK.SEND_TX_999_03;
107
109
  export type PROGRESS_HOOK_MIG = PROGRESS_HOOK.UEA_MIG_01 | PROGRESS_HOOK.UEA_MIG_02 | PROGRESS_HOOK.UEA_MIG_03 | PROGRESS_HOOK.UEA_MIG_9901 | PROGRESS_HOOK.UEA_MIG_9902 | PROGRESS_HOOK.UEA_MIG_9903;
108
110
  export {};
package/src/lib/progress-hook/progress-hook.types.js CHANGED
@@ -30,15 +30,15 @@ var PROGRESS_HOOK;
30
30
  PROGRESS_HOOK["SEND_TX_107"] = "SEND-TX-107";
31
31
  PROGRESS_HOOK["SEND_TX_199_01"] = "SEND-TX-199-01";
32
32
  PROGRESS_HOOK["SEND_TX_199_02"] = "SEND-TX-199-02";
33
- PROGRESS_HOOK["SEND_TX_199_99_99"] = "SEND-TX-199-99-99";
33
+ PROGRESS_HOOK["SEND_TX_199_03"] = "SEND-TX-199-03";
34
+ PROGRESS_HOOK["SEND_TX_199_99"] = "SEND-TX-199-99";
34
35
  // Route 2: UEA → UGPC → CEA on target chain (201–299)
35
36
  PROGRESS_HOOK["SEND_TX_201"] = "SEND-TX-201";
36
37
  PROGRESS_HOOK["SEND_TX_202_01"] = "SEND-TX-202-01";
37
38
  PROGRESS_HOOK["SEND_TX_202_02"] = "SEND-TX-202-02";
38
39
  PROGRESS_HOOK["SEND_TX_203_01"] = "SEND-TX-203-01";
39
40
  PROGRESS_HOOK["SEND_TX_203_02"] = "SEND-TX-203-02";
40
- // Pre-flight balance check (203-03 INFO when sufficient, WARNING when
41
- // short but enforceGasCheck=false, ERROR when enforceGasCheck=true;
41
+ // Pre-flight balance check (203-03 INFO when sufficient, WARNING when short;
42
42
  // 203-04 ERROR terminal precursor on enforced shortfall;
43
43
  // 203-05 INFO SVM warn-threshold tripped).
44
44
  // 203 bucket choice is temporal (sits between 203-02 CEA-resolved and 204-01 sign),
@@ -87,6 +87,7 @@ var PROGRESS_HOOK;
87
87
  PROGRESS_HOOK["SEND_TX_399_01"] = "SEND-TX-399-01";
88
88
  PROGRESS_HOOK["SEND_TX_399_02"] = "SEND-TX-399-02";
89
89
  PROGRESS_HOOK["SEND_TX_399_03"] = "SEND-TX-399-03";
90
+ PROGRESS_HOOK["SEND_TX_399_99"] = "SEND-TX-399-99";
90
91
  // Multichain (multi-hop) cascade markers
91
92
  PROGRESS_HOOK["SEND_TX_001"] = "SEND-TX-001";
92
93
  PROGRESS_HOOK["SEND_TX_002_01"] = "SEND-TX-002-01";
package/src/lib/push-chain/push-chain.d.ts CHANGED
@@ -71,6 +71,8 @@ export declare class PushChain {
71
71
  * @param options.enforceGasCheck - Defaults to false. When true, the
72
72
  * SDK stops on pre-flight gas/balance shortfall instead of warning
73
73
  * and proceeding.
74
+ * @param params.progressHook - Optional per-call progress callback.
75
+ * Alias for `sendTransaction(params, { progressHook })`.
74
76
  * @param options.progressHook - Optional per-call progress callback.
75
77
  * Additive with the init-time `progressHook` passed to `initialize`:
76
78
  * both hooks receive every `ProgressEvent` emitted during this call.