moltspay 1.3.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.
Files changed (57) hide show
  1. package/README.md +221 -38
  2. package/dist/cdp/index.d.mts +4 -4
  3. package/dist/cdp/index.d.ts +4 -4
  4. package/dist/cdp/index.js +57 -0
  5. package/dist/cdp/index.js.map +1 -1
  6. package/dist/cdp/index.mjs +57 -0
  7. package/dist/cdp/index.mjs.map +1 -1
  8. package/dist/chains/index.d.mts +9 -8
  9. package/dist/chains/index.d.ts +9 -8
  10. package/dist/chains/index.js +57 -0
  11. package/dist/chains/index.js.map +1 -1
  12. package/dist/chains/index.mjs +57 -0
  13. package/dist/chains/index.mjs.map +1 -1
  14. package/dist/cli/index.js +1975 -273
  15. package/dist/cli/index.js.map +1 -1
  16. package/dist/cli/index.mjs +1977 -265
  17. package/dist/cli/index.mjs.map +1 -1
  18. package/dist/client/index.d.mts +36 -3
  19. package/dist/client/index.d.ts +36 -3
  20. package/dist/client/index.js +540 -32
  21. package/dist/client/index.js.map +1 -1
  22. package/dist/client/index.mjs +548 -30
  23. package/dist/client/index.mjs.map +1 -1
  24. package/dist/facilitators/index.d.mts +220 -1
  25. package/dist/facilitators/index.d.ts +220 -1
  26. package/dist/facilitators/index.js +664 -1
  27. package/dist/facilitators/index.js.map +1 -1
  28. package/dist/facilitators/index.mjs +670 -1
  29. package/dist/facilitators/index.mjs.map +1 -1
  30. package/dist/{index-On9ZaGDW.d.mts → index-D_2FkLwV.d.mts} +6 -2
  31. package/dist/{index-On9ZaGDW.d.ts → index-D_2FkLwV.d.ts} +6 -2
  32. package/dist/index.d.mts +2 -1
  33. package/dist/index.d.ts +2 -1
  34. package/dist/index.js +1413 -146
  35. package/dist/index.js.map +1 -1
  36. package/dist/index.mjs +1421 -144
  37. package/dist/index.mjs.map +1 -1
  38. package/dist/server/index.d.mts +13 -3
  39. package/dist/server/index.d.ts +13 -3
  40. package/dist/server/index.js +905 -52
  41. package/dist/server/index.js.map +1 -1
  42. package/dist/server/index.mjs +915 -52
  43. package/dist/server/index.mjs.map +1 -1
  44. package/dist/verify/index.d.mts +1 -1
  45. package/dist/verify/index.d.ts +1 -1
  46. package/dist/verify/index.js +57 -0
  47. package/dist/verify/index.js.map +1 -1
  48. package/dist/verify/index.mjs +57 -0
  49. package/dist/verify/index.mjs.map +1 -1
  50. package/dist/wallet/index.d.mts +3 -3
  51. package/dist/wallet/index.d.ts +3 -3
  52. package/dist/wallet/index.js +57 -0
  53. package/dist/wallet/index.js.map +1 -1
  54. package/dist/wallet/index.mjs +57 -0
  55. package/dist/wallet/index.mjs.map +1 -1
  56. package/package.json +4 -1
  57. package/schemas/moltspay.services.schema.json +27 -132
@@ -1,4 +1,5 @@
1
- import { T as TokenSymbol } from '../index-On9ZaGDW.mjs';
1
+ import { Wallet } from 'ethers';
2
+ import { T as TokenSymbol } from '../index-D_2FkLwV.mjs';
2
3
 
3
4
  /**
4
5
  * MoltsPay Client Types
@@ -78,8 +79,8 @@ interface PayOptions {
78
79
  token?: TokenSymbol;
79
80
  /** Auto-select token based on balance (default: false) */
80
81
  autoSelect?: boolean;
81
- /** Chain to pay on (base, polygon, or base_sepolia, default: base) */
82
- chain?: 'base' | 'polygon' | 'base_sepolia';
82
+ /** Chain to pay on */
83
+ chain?: 'base' | 'polygon' | 'base_sepolia' | 'tempo_moderato' | 'bnb' | 'bnb_testnet' | 'solana' | 'solana_devnet';
83
84
  }
84
85
  declare class MoltsPayClient {
85
86
  private configDir;
@@ -97,6 +98,10 @@ declare class MoltsPayClient {
97
98
  * Get wallet address
98
99
  */
99
100
  get address(): string | null;
101
+ /**
102
+ * Get wallet instance (for direct operations like approvals)
103
+ */
104
+ getWallet(): Wallet | null;
100
105
  /**
101
106
  * Get current config
102
107
  */
@@ -121,6 +126,34 @@ declare class MoltsPayClient {
121
126
  * @param options - Payment options (token selection)
122
127
  */
123
128
  pay(serverUrl: string, service: string, params: Record<string, any>, options?: PayOptions): Promise<Record<string, any>>;
129
+ /**
130
+ * Handle MPP (Machine Payments Protocol) payment flow
131
+ * Called when pay() detects WWW-Authenticate header in 402 response
132
+ */
133
+ private handleMPPPayment;
134
+ /**
135
+ * Handle BNB Chain payment flow (pre-approval + intent signature)
136
+ *
137
+ * Flow:
138
+ * 1. Check client has approved server wallet (done via `moltspay init`)
139
+ * 2. Sign EIP-712 payment intent (no gas, just signature)
140
+ * 3. Send intent to server
141
+ * 4. Server executes service
142
+ * 5. Server calls transferFrom if successful (pay-for-success)
143
+ */
144
+ private handleBNBPayment;
145
+ /**
146
+ * Handle Solana payment flow
147
+ *
148
+ * Solana uses SPL token transfers with pay-for-success model:
149
+ * 1. Client creates and signs a transfer transaction
150
+ * 2. Server submits the transaction after service completes
151
+ */
152
+ private handleSolanaPayment;
153
+ /**
154
+ * Check ERC20 allowance for a spender
155
+ */
156
+ private checkAllowance;
124
157
  /**
125
158
  * Sign EIP-3009 transferWithAuthorization (GASLESS)
126
159
  * This only signs - no on-chain transaction, no gas needed.
@@ -1,4 +1,5 @@
1
- import { T as TokenSymbol } from '../index-On9ZaGDW.js';
1
+ import { Wallet } from 'ethers';
2
+ import { T as TokenSymbol } from '../index-D_2FkLwV.js';
2
3
 
3
4
  /**
4
5
  * MoltsPay Client Types
@@ -78,8 +79,8 @@ interface PayOptions {
78
79
  token?: TokenSymbol;
79
80
  /** Auto-select token based on balance (default: false) */
80
81
  autoSelect?: boolean;
81
- /** Chain to pay on (base, polygon, or base_sepolia, default: base) */
82
- chain?: 'base' | 'polygon' | 'base_sepolia';
82
+ /** Chain to pay on */
83
+ chain?: 'base' | 'polygon' | 'base_sepolia' | 'tempo_moderato' | 'bnb' | 'bnb_testnet' | 'solana' | 'solana_devnet';
83
84
  }
84
85
  declare class MoltsPayClient {
85
86
  private configDir;
@@ -97,6 +98,10 @@ declare class MoltsPayClient {
97
98
  * Get wallet address
98
99
  */
99
100
  get address(): string | null;
101
+ /**
102
+ * Get wallet instance (for direct operations like approvals)
103
+ */
104
+ getWallet(): Wallet | null;
100
105
  /**
101
106
  * Get current config
102
107
  */
@@ -121,6 +126,34 @@ declare class MoltsPayClient {
121
126
  * @param options - Payment options (token selection)
122
127
  */
123
128
  pay(serverUrl: string, service: string, params: Record<string, any>, options?: PayOptions): Promise<Record<string, any>>;
129
+ /**
130
+ * Handle MPP (Machine Payments Protocol) payment flow
131
+ * Called when pay() detects WWW-Authenticate header in 402 response
132
+ */
133
+ private handleMPPPayment;
134
+ /**
135
+ * Handle BNB Chain payment flow (pre-approval + intent signature)
136
+ *
137
+ * Flow:
138
+ * 1. Check client has approved server wallet (done via `moltspay init`)
139
+ * 2. Sign EIP-712 payment intent (no gas, just signature)
140
+ * 3. Send intent to server
141
+ * 4. Server executes service
142
+ * 5. Server calls transferFrom if successful (pay-for-success)
143
+ */
144
+ private handleBNBPayment;
145
+ /**
146
+ * Handle Solana payment flow
147
+ *
148
+ * Solana uses SPL token transfers with pay-for-success model:
149
+ * 1. Client creates and signs a transfer transaction
150
+ * 2. Server submits the transaction after service completes
151
+ */
152
+ private handleSolanaPayment;
153
+ /**
154
+ * Check ERC20 allowance for a spender
155
+ */
156
+ private checkAllowance;
124
157
  /**
125
158
  * Sign EIP-3009 transferWithAuthorization (GASLESS)
126
159
  * This only signs - no on-chain transaction, no gas needed.