phygital-payment-sdk 0.1.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 (318) hide show
  1. package/README.md +120 -0
  2. package/dist/arbiter/client.d.ts +34 -0
  3. package/dist/arbiter/client.d.ts.map +1 -0
  4. package/dist/arbiter/client.js +106 -0
  5. package/dist/arbiter/client.js.map +1 -0
  6. package/dist/core/amounts.d.ts +4 -0
  7. package/dist/core/amounts.d.ts.map +1 -0
  8. package/dist/core/amounts.js +36 -0
  9. package/dist/core/amounts.js.map +1 -0
  10. package/dist/core/bytes.d.ts +11 -0
  11. package/dist/core/bytes.d.ts.map +1 -0
  12. package/dist/core/bytes.js +69 -0
  13. package/dist/core/bytes.js.map +1 -0
  14. package/dist/core/challenge.d.ts +15 -0
  15. package/dist/core/challenge.d.ts.map +1 -0
  16. package/dist/core/challenge.js +24 -0
  17. package/dist/core/challenge.js.map +1 -0
  18. package/dist/core/errors.d.ts +90 -0
  19. package/dist/core/errors.d.ts.map +1 -0
  20. package/dist/core/errors.js +204 -0
  21. package/dist/core/errors.js.map +1 -0
  22. package/dist/core/events.d.ts +113 -0
  23. package/dist/core/events.d.ts.map +1 -0
  24. package/dist/core/events.js +258 -0
  25. package/dist/core/events.js.map +1 -0
  26. package/dist/core/evidence.d.ts +3 -0
  27. package/dist/core/evidence.d.ts.map +1 -0
  28. package/dist/core/evidence.js +7 -0
  29. package/dist/core/evidence.js.map +1 -0
  30. package/dist/core/execution-plan.d.ts +25 -0
  31. package/dist/core/execution-plan.d.ts.map +1 -0
  32. package/dist/core/execution-plan.js +57 -0
  33. package/dist/core/execution-plan.js.map +1 -0
  34. package/dist/core/indexer-store.d.ts +31 -0
  35. package/dist/core/indexer-store.d.ts.map +1 -0
  36. package/dist/core/indexer-store.js +2 -0
  37. package/dist/core/indexer-store.js.map +1 -0
  38. package/dist/core/instruction-codec.d.ts +13 -0
  39. package/dist/core/instruction-codec.d.ts.map +1 -0
  40. package/dist/core/instruction-codec.js +23 -0
  41. package/dist/core/instruction-codec.js.map +1 -0
  42. package/dist/core/payment.d.ts +116 -0
  43. package/dist/core/payment.d.ts.map +1 -0
  44. package/dist/core/payment.js +185 -0
  45. package/dist/core/payment.js.map +1 -0
  46. package/dist/core/pda.d.ts +29 -0
  47. package/dist/core/pda.d.ts.map +1 -0
  48. package/dist/core/pda.js +48 -0
  49. package/dist/core/pda.js.map +1 -0
  50. package/dist/core/provider-fee-payer.d.ts +5 -0
  51. package/dist/core/provider-fee-payer.d.ts.map +1 -0
  52. package/dist/core/provider-fee-payer.js +17 -0
  53. package/dist/core/provider-fee-payer.js.map +1 -0
  54. package/dist/core/provider-transport.d.ts +79 -0
  55. package/dist/core/provider-transport.d.ts.map +1 -0
  56. package/dist/core/provider-transport.js +151 -0
  57. package/dist/core/provider-transport.js.map +1 -0
  58. package/dist/core/status.d.ts +13 -0
  59. package/dist/core/status.d.ts.map +1 -0
  60. package/dist/core/status.js +17 -0
  61. package/dist/core/status.js.map +1 -0
  62. package/dist/core/time.d.ts +29 -0
  63. package/dist/core/time.d.ts.map +1 -0
  64. package/dist/core/time.js +66 -0
  65. package/dist/core/time.js.map +1 -0
  66. package/dist/core/transactions.d.ts +16 -0
  67. package/dist/core/transactions.d.ts.map +1 -0
  68. package/dist/core/transactions.js +87 -0
  69. package/dist/core/transactions.js.map +1 -0
  70. package/dist/generated/accounts/arbiter.d.ts +31 -0
  71. package/dist/generated/accounts/arbiter.d.ts.map +1 -0
  72. package/dist/generated/accounts/arbiter.js +57 -0
  73. package/dist/generated/accounts/arbiter.js.map +1 -0
  74. package/dist/generated/accounts/index.d.ts +5 -0
  75. package/dist/generated/accounts/index.d.ts.map +1 -0
  76. package/dist/generated/accounts/index.js +5 -0
  77. package/dist/generated/accounts/index.js.map +1 -0
  78. package/dist/generated/accounts/merchantOperator.d.ts +25 -0
  79. package/dist/generated/accounts/merchantOperator.d.ts.map +1 -0
  80. package/dist/generated/accounts/merchantOperator.js +49 -0
  81. package/dist/generated/accounts/merchantOperator.js.map +1 -0
  82. package/dist/generated/accounts/payment.d.ts +56 -0
  83. package/dist/generated/accounts/payment.d.ts.map +1 -0
  84. package/dist/generated/accounts/payment.js +82 -0
  85. package/dist/generated/accounts/payment.js.map +1 -0
  86. package/dist/generated/accounts/paymentAccount.d.ts +59 -0
  87. package/dist/generated/accounts/paymentAccount.d.ts.map +1 -0
  88. package/dist/generated/accounts/paymentAccount.js +83 -0
  89. package/dist/generated/accounts/paymentAccount.js.map +1 -0
  90. package/dist/generated/errors/index.d.ts +2 -0
  91. package/dist/generated/errors/index.d.ts.map +1 -0
  92. package/dist/generated/errors/index.js +2 -0
  93. package/dist/generated/errors/index.js.map +1 -0
  94. package/dist/generated/errors/phygitalPayment.d.ts +50 -0
  95. package/dist/generated/errors/phygitalPayment.d.ts.map +1 -0
  96. package/dist/generated/errors/phygitalPayment.js +91 -0
  97. package/dist/generated/errors/phygitalPayment.js.map +1 -0
  98. package/dist/generated/index.d.ts +7 -0
  99. package/dist/generated/index.d.ts.map +1 -0
  100. package/dist/generated/index.js +7 -0
  101. package/dist/generated/index.js.map +1 -0
  102. package/dist/generated/instructions/addMerchantOperator.d.ts +49 -0
  103. package/dist/generated/instructions/addMerchantOperator.d.ts.map +1 -0
  104. package/dist/generated/instructions/addMerchantOperator.js +110 -0
  105. package/dist/generated/instructions/addMerchantOperator.js.map +1 -0
  106. package/dist/generated/instructions/autoRefund.d.ts +48 -0
  107. package/dist/generated/instructions/autoRefund.d.ts.map +1 -0
  108. package/dist/generated/instructions/autoRefund.js +91 -0
  109. package/dist/generated/instructions/autoRefund.js.map +1 -0
  110. package/dist/generated/instructions/autoSettle.d.ts +45 -0
  111. package/dist/generated/instructions/autoSettle.d.ts.map +1 -0
  112. package/dist/generated/instructions/autoSettle.js +82 -0
  113. package/dist/generated/instructions/autoSettle.js.map +1 -0
  114. package/dist/generated/instructions/closeExpiredPayment.d.ts +36 -0
  115. package/dist/generated/instructions/closeExpiredPayment.d.ts.map +1 -0
  116. package/dist/generated/instructions/closeExpiredPayment.js +64 -0
  117. package/dist/generated/instructions/closeExpiredPayment.js.map +1 -0
  118. package/dist/generated/instructions/dispute.d.ts +49 -0
  119. package/dist/generated/instructions/dispute.d.ts.map +1 -0
  120. package/dist/generated/instructions/dispute.js +84 -0
  121. package/dist/generated/instructions/dispute.js.map +1 -0
  122. package/dist/generated/instructions/disputeAuthorization.d.ts +73 -0
  123. package/dist/generated/instructions/disputeAuthorization.d.ts.map +1 -0
  124. package/dist/generated/instructions/disputeAuthorization.js +149 -0
  125. package/dist/generated/instructions/disputeAuthorization.js.map +1 -0
  126. package/dist/generated/instructions/index.d.ts +21 -0
  127. package/dist/generated/instructions/index.d.ts.map +1 -0
  128. package/dist/generated/instructions/index.js +21 -0
  129. package/dist/generated/instructions/index.js.map +1 -0
  130. package/dist/generated/instructions/merchantRefund.d.ts +43 -0
  131. package/dist/generated/instructions/merchantRefund.d.ts.map +1 -0
  132. package/dist/generated/instructions/merchantRefund.js +78 -0
  133. package/dist/generated/instructions/merchantRefund.js.map +1 -0
  134. package/dist/generated/instructions/merchantRespond.d.ts +43 -0
  135. package/dist/generated/instructions/merchantRespond.d.ts.map +1 -0
  136. package/dist/generated/instructions/merchantRespond.js +78 -0
  137. package/dist/generated/instructions/merchantRespond.js.map +1 -0
  138. package/dist/generated/instructions/refundSettled.d.ts +52 -0
  139. package/dist/generated/instructions/refundSettled.d.ts.map +1 -0
  140. package/dist/generated/instructions/refundSettled.js +88 -0
  141. package/dist/generated/instructions/refundSettled.js.map +1 -0
  142. package/dist/generated/instructions/registerArbiter.d.ts +44 -0
  143. package/dist/generated/instructions/registerArbiter.d.ts.map +1 -0
  144. package/dist/generated/instructions/registerArbiter.js +94 -0
  145. package/dist/generated/instructions/registerArbiter.js.map +1 -0
  146. package/dist/generated/instructions/removeMerchantOperator.d.ts +45 -0
  147. package/dist/generated/instructions/removeMerchantOperator.d.ts.map +1 -0
  148. package/dist/generated/instructions/removeMerchantOperator.js +97 -0
  149. package/dist/generated/instructions/removeMerchantOperator.js.map +1 -0
  150. package/dist/generated/instructions/resolveDispute.d.ts +55 -0
  151. package/dist/generated/instructions/resolveDispute.d.ts.map +1 -0
  152. package/dist/generated/instructions/resolveDispute.js +91 -0
  153. package/dist/generated/instructions/resolveDispute.js.map +1 -0
  154. package/dist/generated/instructions/setApprovedArbiter.d.ts +57 -0
  155. package/dist/generated/instructions/setApprovedArbiter.d.ts.map +1 -0
  156. package/dist/generated/instructions/setApprovedArbiter.js +121 -0
  157. package/dist/generated/instructions/setApprovedArbiter.js.map +1 -0
  158. package/dist/generated/instructions/setAuthorizedCredential.d.ts +64 -0
  159. package/dist/generated/instructions/setAuthorizedCredential.d.ts.map +1 -0
  160. package/dist/generated/instructions/setAuthorizedCredential.js +138 -0
  161. package/dist/generated/instructions/setAuthorizedCredential.js.map +1 -0
  162. package/dist/generated/instructions/setPaymentEnabler.d.ts +65 -0
  163. package/dist/generated/instructions/setPaymentEnabler.d.ts.map +1 -0
  164. package/dist/generated/instructions/setPaymentEnabler.js +136 -0
  165. package/dist/generated/instructions/setPaymentEnabler.js.map +1 -0
  166. package/dist/generated/instructions/setReserve.d.ts +53 -0
  167. package/dist/generated/instructions/setReserve.d.ts.map +1 -0
  168. package/dist/generated/instructions/setReserve.js +109 -0
  169. package/dist/generated/instructions/setReserve.js.map +1 -0
  170. package/dist/generated/instructions/setTapLimit.d.ts +53 -0
  171. package/dist/generated/instructions/setTapLimit.d.ts.map +1 -0
  172. package/dist/generated/instructions/setTapLimit.js +109 -0
  173. package/dist/generated/instructions/setTapLimit.js.map +1 -0
  174. package/dist/generated/instructions/transfer.d.ts +97 -0
  175. package/dist/generated/instructions/transfer.d.ts.map +1 -0
  176. package/dist/generated/instructions/transfer.js +182 -0
  177. package/dist/generated/instructions/transfer.js.map +1 -0
  178. package/dist/generated/instructions/withdrawDispute.d.ts +36 -0
  179. package/dist/generated/instructions/withdrawDispute.d.ts.map +1 -0
  180. package/dist/generated/instructions/withdrawDispute.js +61 -0
  181. package/dist/generated/instructions/withdrawDispute.js.map +1 -0
  182. package/dist/generated/instructions/withdrawFromEscrow.d.ts +61 -0
  183. package/dist/generated/instructions/withdrawFromEscrow.d.ts.map +1 -0
  184. package/dist/generated/instructions/withdrawFromEscrow.js +132 -0
  185. package/dist/generated/instructions/withdrawFromEscrow.js.map +1 -0
  186. package/dist/generated/pdas/arbiterAccount.d.ts +8 -0
  187. package/dist/generated/pdas/arbiterAccount.d.ts.map +1 -0
  188. package/dist/generated/pdas/arbiterAccount.js +12 -0
  189. package/dist/generated/pdas/arbiterAccount.js.map +1 -0
  190. package/dist/generated/pdas/index.d.ts +6 -0
  191. package/dist/generated/pdas/index.d.ts.map +1 -0
  192. package/dist/generated/pdas/index.js +6 -0
  193. package/dist/generated/pdas/index.js.map +1 -0
  194. package/dist/generated/pdas/merchantOperator.d.ts +9 -0
  195. package/dist/generated/pdas/merchantOperator.d.ts.map +1 -0
  196. package/dist/generated/pdas/merchantOperator.js +16 -0
  197. package/dist/generated/pdas/merchantOperator.js.map +1 -0
  198. package/dist/generated/pdas/payment.d.ts +9 -0
  199. package/dist/generated/pdas/payment.d.ts.map +1 -0
  200. package/dist/generated/pdas/payment.js +13 -0
  201. package/dist/generated/pdas/payment.js.map +1 -0
  202. package/dist/generated/pdas/paymentAccount.d.ts +10 -0
  203. package/dist/generated/pdas/paymentAccount.d.ts.map +1 -0
  204. package/dist/generated/pdas/paymentAccount.js +16 -0
  205. package/dist/generated/pdas/paymentAccount.js.map +1 -0
  206. package/dist/generated/pdas/setApprovedArbiterArbiterAccount.d.ts +8 -0
  207. package/dist/generated/pdas/setApprovedArbiterArbiterAccount.d.ts.map +1 -0
  208. package/dist/generated/pdas/setApprovedArbiterArbiterAccount.js +12 -0
  209. package/dist/generated/pdas/setApprovedArbiterArbiterAccount.js.map +1 -0
  210. package/dist/generated/programs/index.d.ts +2 -0
  211. package/dist/generated/programs/index.d.ts.map +1 -0
  212. package/dist/generated/programs/index.js +2 -0
  213. package/dist/generated/programs/index.js.map +1 -0
  214. package/dist/generated/programs/phygitalPayment.d.ts +132 -0
  215. package/dist/generated/programs/phygitalPayment.d.ts.map +1 -0
  216. package/dist/generated/programs/phygitalPayment.js +322 -0
  217. package/dist/generated/programs/phygitalPayment.js.map +1 -0
  218. package/dist/generated/types/index.d.ts +2 -0
  219. package/dist/generated/types/index.d.ts.map +1 -0
  220. package/dist/generated/types/index.js +2 -0
  221. package/dist/generated/types/index.js.map +1 -0
  222. package/dist/generated/types/paymentFlags.d.ts +7 -0
  223. package/dist/generated/types/paymentFlags.d.ts.map +1 -0
  224. package/dist/generated/types/paymentFlags.js +11 -0
  225. package/dist/generated/types/paymentFlags.js.map +1 -0
  226. package/dist/index.d.ts +25 -0
  227. package/dist/index.d.ts.map +1 -0
  228. package/dist/index.js +23 -0
  229. package/dist/index.js.map +1 -0
  230. package/dist/merchant/charge.d.ts +106 -0
  231. package/dist/merchant/charge.d.ts.map +1 -0
  232. package/dist/merchant/charge.js +311 -0
  233. package/dist/merchant/charge.js.map +1 -0
  234. package/dist/merchant/client.d.ts +80 -0
  235. package/dist/merchant/client.d.ts.map +1 -0
  236. package/dist/merchant/client.js +282 -0
  237. package/dist/merchant/client.js.map +1 -0
  238. package/dist/merchant/deferred-queue.d.ts +35 -0
  239. package/dist/merchant/deferred-queue.d.ts.map +1 -0
  240. package/dist/merchant/deferred-queue.js +237 -0
  241. package/dist/merchant/deferred-queue.js.map +1 -0
  242. package/dist/merchant/deferred-store.d.ts +67 -0
  243. package/dist/merchant/deferred-store.d.ts.map +1 -0
  244. package/dist/merchant/deferred-store.js +126 -0
  245. package/dist/merchant/deferred-store.js.map +1 -0
  246. package/dist/merchant/indexed-db-store.d.ts +6 -0
  247. package/dist/merchant/indexed-db-store.d.ts.map +1 -0
  248. package/dist/merchant/indexed-db-store.js +121 -0
  249. package/dist/merchant/indexed-db-store.js.map +1 -0
  250. package/dist/merchant/tap.d.ts +11 -0
  251. package/dist/merchant/tap.d.ts.map +1 -0
  252. package/dist/merchant/tap.js +47 -0
  253. package/dist/merchant/tap.js.map +1 -0
  254. package/dist/server/closable-store.d.ts +12 -0
  255. package/dist/server/closable-store.d.ts.map +1 -0
  256. package/dist/server/closable-store.js +16 -0
  257. package/dist/server/closable-store.js.map +1 -0
  258. package/dist/server/deferred-flusher.d.ts +19 -0
  259. package/dist/server/deferred-flusher.d.ts.map +1 -0
  260. package/dist/server/deferred-flusher.js +57 -0
  261. package/dist/server/deferred-flusher.js.map +1 -0
  262. package/dist/server/enabler-service.d.ts +20 -0
  263. package/dist/server/enabler-service.d.ts.map +1 -0
  264. package/dist/server/enabler-service.js +191 -0
  265. package/dist/server/enabler-service.js.map +1 -0
  266. package/dist/server/enabler-signer.d.ts +11 -0
  267. package/dist/server/enabler-signer.d.ts.map +1 -0
  268. package/dist/server/enabler-signer.js +37 -0
  269. package/dist/server/enabler-signer.js.map +1 -0
  270. package/dist/server/fee-budget.d.ts +22 -0
  271. package/dist/server/fee-budget.d.ts.map +1 -0
  272. package/dist/server/fee-budget.js +58 -0
  273. package/dist/server/fee-budget.js.map +1 -0
  274. package/dist/server/fee-payer.d.ts +27 -0
  275. package/dist/server/fee-payer.d.ts.map +1 -0
  276. package/dist/server/fee-payer.js +167 -0
  277. package/dist/server/fee-payer.js.map +1 -0
  278. package/dist/server/index.d.ts +14 -0
  279. package/dist/server/index.d.ts.map +1 -0
  280. package/dist/server/index.js +14 -0
  281. package/dist/server/index.js.map +1 -0
  282. package/dist/server/indexer.d.ts +50 -0
  283. package/dist/server/indexer.d.ts.map +1 -0
  284. package/dist/server/indexer.js +218 -0
  285. package/dist/server/indexer.js.map +1 -0
  286. package/dist/server/keeper.d.ts +34 -0
  287. package/dist/server/keeper.d.ts.map +1 -0
  288. package/dist/server/keeper.js +246 -0
  289. package/dist/server/keeper.js.map +1 -0
  290. package/dist/server/pending-taps.d.ts +12 -0
  291. package/dist/server/pending-taps.d.ts.map +1 -0
  292. package/dist/server/pending-taps.js +19 -0
  293. package/dist/server/pending-taps.js.map +1 -0
  294. package/dist/server/policy.d.ts +46 -0
  295. package/dist/server/policy.d.ts.map +1 -0
  296. package/dist/server/policy.js +47 -0
  297. package/dist/server/policy.js.map +1 -0
  298. package/dist/server/provider-deferred-queue.d.ts +21 -0
  299. package/dist/server/provider-deferred-queue.d.ts.map +1 -0
  300. package/dist/server/provider-deferred-queue.js +69 -0
  301. package/dist/server/provider-deferred-queue.js.map +1 -0
  302. package/dist/server/queue.d.ts +43 -0
  303. package/dist/server/queue.d.ts.map +1 -0
  304. package/dist/server/queue.js +105 -0
  305. package/dist/server/queue.js.map +1 -0
  306. package/dist/server/router.d.ts +21 -0
  307. package/dist/server/router.d.ts.map +1 -0
  308. package/dist/server/router.js +137 -0
  309. package/dist/server/router.js.map +1 -0
  310. package/dist/server/webauthn.d.ts +2 -0
  311. package/dist/server/webauthn.d.ts.map +1 -0
  312. package/dist/server/webauthn.js +19 -0
  313. package/dist/server/webauthn.js.map +1 -0
  314. package/dist/wallet/client.d.ts +106 -0
  315. package/dist/wallet/client.d.ts.map +1 -0
  316. package/dist/wallet/client.js +354 -0
  317. package/dist/wallet/client.js.map +1 -0
  318. package/package.json +75 -0
@@ -0,0 +1,311 @@
1
+ import { TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
2
+ import { bufferToBase64URLString, base64URLStringToBuffer, } from "@simplewebauthn/browser";
3
+ import { address, } from "@solana/kit";
4
+ import { buildVerifyInputFromWebAuthn, findAssetPda, getSecp256r1VerifyInstruction, parseSecp256r1Pubkey, } from "phygital-token-sdk";
5
+ import { fetchPaymentAccount } from "../generated/accounts/paymentAccount.js";
6
+ import { getTransferInstructionAsync } from "../generated/instructions/transfer.js";
7
+ import { assertU64 } from "../core/amounts.js";
8
+ import { bytesEqualConstant, bytesToBase58, bytesToBase64Url, randomReference, toUint8Array, } from "../core/bytes.js";
9
+ import { assertValidReference } from "../core/challenge.js";
10
+ import { ArbiterNotApprovedError, ArbiterRejectedError, ConfigurationError, EnablerMismatchError, InvalidAmountError, PhygitalPaymentSdkError, } from "../core/errors.js";
11
+ import { computeExecutionPlan, } from "../core/execution-plan.js";
12
+ import { effectiveApprovedArbiter, effectiveEnablerPubkey, fetchArbiterReputation, fetchEscrowBalance, } from "../core/payment.js";
13
+ import { deriveEscrowAddress, derivePaymentAccountAddress, derivePaymentAddress, } from "../core/pda.js";
14
+ import { nowSeconds } from "../core/time.js";
15
+ import { serializePendingTap } from "./deferred-store.js";
16
+ import { readPaymentAccessoryCredential } from "./tap.js";
17
+ export class CosignLandError extends PhygitalPaymentSdkError {
18
+ code = "cosign_land_failed";
19
+ cosigned;
20
+ constructor(message, cosigned, options) {
21
+ super(message, options);
22
+ this.cosigned = cosigned;
23
+ }
24
+ }
25
+ const DEFAULT_ADDRESS = address("11111111111111111111111111111111");
26
+ function assertChargeAmount(amount) {
27
+ assertU64(amount);
28
+ if (amount <= 0n) {
29
+ throw new InvalidAmountError(`Charge amount must be greater than zero (got ${amount}).`);
30
+ }
31
+ }
32
+ function throwIfAborted(signal) {
33
+ if (!signal?.aborted)
34
+ return;
35
+ const reason = signal.reason;
36
+ throw reason instanceof Error
37
+ ? reason
38
+ : new DOMException("The operation was aborted.", "AbortError");
39
+ }
40
+ function buildTransferInstructions(ctx, cosigned) {
41
+ const preamble = getSecp256r1VerifyInstruction([
42
+ cosigned.credentialEntry,
43
+ cosigned.enablerEntry,
44
+ ]);
45
+ return getTransferInstructionAsync({
46
+ rentPayer: ctx.feePayer,
47
+ merchant: cosigned.merchant,
48
+ asset: cosigned.asset,
49
+ mint: cosigned.mint,
50
+ paymentAccount: cosigned.paymentAccount,
51
+ payment: cosigned.payment,
52
+ escrowTokenAccount: cosigned.escrowTokenAccount,
53
+ credentialSignedMessageIndex: 0,
54
+ enablerSignedMessageIndex: 1,
55
+ clientDataJson: cosigned.clientDataJson,
56
+ amount: cosigned.amount,
57
+ tapIssuedAt: cosigned.issuedAt,
58
+ reference: cosigned.reference,
59
+ tokenProgram: cosigned.tokenProgram,
60
+ }).then((transferInstruction) => [preamble, transferInstruction]);
61
+ }
62
+ async function persistReceipt(ctx, cosigned, result, pendingTapForReceipt, emit) {
63
+ try {
64
+ await ctx.provider.persistTransferResult({
65
+ txSig: result.kind === "confirmed" ? result.signature : undefined,
66
+ queueId: result.kind === "queued" ? result.queueId : undefined,
67
+ sender: cosigned.payer,
68
+ mint: cosigned.mint,
69
+ tokenProgram: cosigned.tokenProgram,
70
+ amount: cosigned.amount.toString(),
71
+ destination: cosigned.merchant,
72
+ reference: bytesToBase58(cosigned.reference),
73
+ issuedAt: cosigned.issuedAt,
74
+ arbiter: cosigned.arbiter,
75
+ enabler: bufferToBase64URLString(toUint8Array(cosigned.enablerEntry.publicKey).buffer),
76
+ paymentAccessory: bytesToBase64Url(cosigned.paymentAccessory),
77
+ pendingTap: pendingTapForReceipt,
78
+ });
79
+ }
80
+ catch (error) {
81
+ emit({ phase: "receiptPersistFailed", error });
82
+ }
83
+ }
84
+ export async function resumeCharge(ctx, cosigned, params = {}) {
85
+ const emit = params.onProgress ?? (() => { });
86
+ if (cosigned.merchant !== ctx.merchant) {
87
+ throw new ConfigurationError("Cosigned tap merchant does not match this merchant client.");
88
+ }
89
+ let instructions;
90
+ try {
91
+ emit({ phase: "simulating" });
92
+ instructions = await buildTransferInstructions(ctx, cosigned);
93
+ await ctx.runtime.simulate(ctx.feePayer, instructions);
94
+ }
95
+ catch (error) {
96
+ throw new CosignLandError("Co-signed tap failed simulation; retry with resumeCharge — do not re-tap.", cosigned, { cause: error });
97
+ }
98
+ let exposure = cosigned.exposure;
99
+ try {
100
+ const chain = await fetchEscrowBalance(ctx.rpc, {
101
+ owner: cosigned.payer,
102
+ mint: cosigned.mint,
103
+ tokenProgram: cosigned.tokenProgram,
104
+ });
105
+ if (chain !== null && chain.free < exposure.freeEscrow) {
106
+ exposure = { ...exposure, freeEscrow: chain.free };
107
+ }
108
+ }
109
+ catch {
110
+ }
111
+ const computedPlan = computeExecutionPlan(cosigned.reserve, cosigned.amount, cosigned.issuedAt, exposure, cosigned.config);
112
+ const allowDeferral = params.allowDeferral ?? ctx.allowDeferral ?? true;
113
+ const plan = allowDeferral
114
+ ? computedPlan
115
+ : { mode: "immediate" };
116
+ emit({ phase: "submitting", plan });
117
+ let result;
118
+ let pendingTapForReceipt;
119
+ try {
120
+ if (plan.mode === "immediate") {
121
+ const signature = await ctx.runtime.sendAndConfirm(ctx.feePayer, instructions, { skipSimulation: true });
122
+ emit({ phase: "confirmed", signature });
123
+ result = {
124
+ kind: "confirmed",
125
+ signature,
126
+ payment: cosigned.payment,
127
+ reference: cosigned.reference,
128
+ payer: cosigned.payer,
129
+ };
130
+ }
131
+ else {
132
+ if (!ctx.deferredQueue) {
133
+ throw new ConfigurationError("deferredQueue is required when the execution plan defers a tap. Pass deferredStore to createMerchantClient.");
134
+ }
135
+ const enqueuedAt = nowSeconds();
136
+ const referenceBase58 = bytesToBase58(cosigned.reference);
137
+ const pendingFields = {
138
+ reference: referenceBase58,
139
+ executeBy: plan.executeBy,
140
+ enqueuedAt,
141
+ merchant: cosigned.merchant,
142
+ credentialEntry: cosigned.credentialEntry,
143
+ enablerEntry: cosigned.enablerEntry,
144
+ clientDataJson: cosigned.clientDataJson,
145
+ payer: cosigned.payer,
146
+ mint: cosigned.mint,
147
+ tokenProgram: cosigned.tokenProgram,
148
+ amount: cosigned.amount.toString(),
149
+ arbiter: cosigned.arbiter,
150
+ tapIssuedAt: cosigned.issuedAt,
151
+ asset: cosigned.asset,
152
+ paymentAccount: cosigned.paymentAccount,
153
+ payment: cosigned.payment,
154
+ escrowTokenAccount: cosigned.escrowTokenAccount,
155
+ };
156
+ const queueId = await ctx.deferredQueue.enqueue(pendingFields);
157
+ pendingTapForReceipt = serializePendingTap({
158
+ ...pendingFields,
159
+ id: queueId,
160
+ attempts: 0,
161
+ });
162
+ emit({ phase: "queued", queueId, executeBy: plan.executeBy });
163
+ result = {
164
+ kind: "queued",
165
+ queueId,
166
+ executeBy: plan.executeBy,
167
+ payment: cosigned.payment,
168
+ reference: cosigned.reference,
169
+ payer: cosigned.payer,
170
+ };
171
+ }
172
+ }
173
+ catch (error) {
174
+ if (error instanceof CosignLandError ||
175
+ error instanceof ConfigurationError) {
176
+ throw error;
177
+ }
178
+ throw new CosignLandError("Co-signed tap failed to land or queue; retry with resumeCharge — do not re-tap.", cosigned, { cause: error });
179
+ }
180
+ await persistReceipt(ctx, cosigned, result, pendingTapForReceipt, emit);
181
+ return result;
182
+ }
183
+ export async function charge(ctx, params) {
184
+ const emit = params.onProgress ?? (() => { });
185
+ assertChargeAmount(params.amount);
186
+ if (params.issuedAt !== undefined && params.reference === undefined) {
187
+ throw new ConfigurationError("issuedAt requires an explicit reference so the provider cosign cache can match the prior tap fingerprint.");
188
+ }
189
+ const reference = params.reference ?? randomReference();
190
+ assertValidReference(reference);
191
+ const issuedAt = params.issuedAt ?? nowSeconds();
192
+ throwIfAborted(params.abortSignal);
193
+ const challengeFields = {
194
+ mint: params.mint,
195
+ amount: params.amount,
196
+ merchant: ctx.merchant,
197
+ reference,
198
+ issuedAt,
199
+ };
200
+ emit({ phase: "awaitingTap" });
201
+ const { response, challenge } = await readPaymentAccessoryCredential(challengeFields, { rpId: ctx.rpId, abortSignal: params.abortSignal });
202
+ emit({ phase: "credentialRead", credentialId: response.id });
203
+ throwIfAborted(params.abortSignal);
204
+ emit({ phase: "verifying" });
205
+ const referenceBase58 = bytesToBase58(reference);
206
+ const { enabler: enablerEntry, paymentAccessory, payer, outstandingExposure, freeEscrow, } = await ctx.provider.getEnablerSignature({
207
+ response,
208
+ mint: params.mint,
209
+ amount: params.amount.toString(),
210
+ destination: ctx.merchant,
211
+ reference: referenceBase58,
212
+ issuedAt,
213
+ tokenProgram: ctx.tokenProgram,
214
+ }, challenge, params.abortSignal);
215
+ const paymentAccessoryKey = bytesToBase64Url(paymentAccessory);
216
+ const paymentAccountAddress = await derivePaymentAccountAddress({
217
+ owner: payer,
218
+ mint: params.mint,
219
+ tokenProgram: ctx.tokenProgram,
220
+ });
221
+ const [paymentAccount, escrowTokenAccount, paymentAddress, assetPda, chainEscrow,] = await Promise.all([
222
+ fetchPaymentAccount(ctx.rpc, paymentAccountAddress),
223
+ deriveEscrowAddress({
224
+ owner: payer,
225
+ mint: params.mint,
226
+ tokenProgram: ctx.tokenProgram,
227
+ }),
228
+ derivePaymentAddress({ paymentAccount: paymentAccountAddress, reference }),
229
+ findAssetPda(parseSecp256r1Pubkey(paymentAccessoryKey)),
230
+ fetchEscrowBalance(ctx.rpc, {
231
+ owner: payer,
232
+ mint: params.mint,
233
+ tokenProgram: ctx.tokenProgram,
234
+ }).catch(() => null),
235
+ ]);
236
+ const registeredEnabler = effectiveEnablerPubkey({
237
+ enablerPubkey: toUint8Array(paymentAccount.data.enablerPubkey),
238
+ pendingEnablerPubkey: toUint8Array(paymentAccount.data.pendingEnablerPubkey),
239
+ enablerEffectiveAt: paymentAccount.data.enablerEffectiveAt,
240
+ });
241
+ const returnedEnabler = new Uint8Array(enablerEntry.publicKey);
242
+ if (!bytesEqualConstant(registeredEnabler, returnedEnabler)) {
243
+ throw new EnablerMismatchError(registeredEnabler, returnedEnabler);
244
+ }
245
+ const approvedArbiter = effectiveApprovedArbiter({
246
+ approvedArbiter: paymentAccount.data.approvedArbiter,
247
+ pendingApprovedArbiter: paymentAccount.data.pendingApprovedArbiter,
248
+ arbiterEffectiveAt: paymentAccount.data.arbiterEffectiveAt,
249
+ });
250
+ if (approvedArbiter === DEFAULT_ADDRESS) {
251
+ throw new ArbiterNotApprovedError("The payer has not approved an arbiter, so this payment cannot be taken.");
252
+ }
253
+ if (params.acceptArbiter) {
254
+ const reputation = await fetchArbiterReputation(ctx.rpc, approvedArbiter);
255
+ const accepted = await params.acceptArbiter({
256
+ arbiter: approvedArbiter,
257
+ reputation,
258
+ });
259
+ if (!accepted) {
260
+ throw new ArbiterRejectedError(approvedArbiter);
261
+ }
262
+ }
263
+ const clampedFreeEscrow = chainEscrow !== null && chainEscrow.free < freeEscrow
264
+ ? chainEscrow.free
265
+ : freeEscrow;
266
+ const clientDataJson = new Uint8Array(base64URLStringToBuffer(response.response.clientDataJSON));
267
+ const credentialEntry = buildVerifyInputFromWebAuthn({
268
+ publicKey: paymentAccessoryKey,
269
+ response,
270
+ });
271
+ const cosigned = {
272
+ reference,
273
+ issuedAt,
274
+ amount: params.amount,
275
+ mint: params.mint,
276
+ arbiter: approvedArbiter,
277
+ payer,
278
+ merchant: ctx.merchant,
279
+ tokenProgram: ctx.tokenProgram,
280
+ paymentAccessory,
281
+ credentialEntry,
282
+ enablerEntry,
283
+ clientDataJson,
284
+ asset: assetPda,
285
+ paymentAccount: paymentAccountAddress,
286
+ payment: paymentAddress,
287
+ escrowTokenAccount,
288
+ reserve: {
289
+ reserveAmount: paymentAccount.data.reserveAmount,
290
+ pendingReserveAmount: paymentAccount.data.pendingReserveAmount,
291
+ reserveEffectiveAt: paymentAccount.data.reserveEffectiveAt,
292
+ },
293
+ config: {
294
+ enablerEffectiveAt: paymentAccount.data.enablerEffectiveAt,
295
+ credentialEffectiveAt: paymentAccount.data.credentialEffectiveAt,
296
+ arbiterEffectiveAt: paymentAccount.data.arbiterEffectiveAt,
297
+ tapLimitEffectiveAt: paymentAccount.data.tapLimitEffectiveAt,
298
+ pendingMaxTapAmount: paymentAccount.data.pendingMaxTapAmount,
299
+ },
300
+ exposure: {
301
+ outstandingExposure,
302
+ freeEscrow: clampedFreeEscrow,
303
+ },
304
+ };
305
+ return resumeCharge(ctx, cosigned, {
306
+ onProgress: emit,
307
+ allowDeferral: params.allowDeferral,
308
+ });
309
+ }
310
+ export const DEFAULT_TOKEN_PROGRAM = TOKEN_PROGRAM_ADDRESS;
311
+ //# sourceMappingURL=charge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"charge.js","sourceRoot":"","sources":["../../src/merchant/charge.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ import type { Address, Rpc, RpcSubscriptions, Signature, SolanaRpcApi, SolanaRpcSubscriptionsApi, TransactionSigner } from "@solana/kit";
2
+ import { type EventWithContext } from "../core/events.js";
3
+ import { type PaymentSummary, type SdkRpc } from "../core/payment.js";
4
+ import { type ProviderTransport, type ProviderTransportConfig } from "../core/provider-transport.js";
5
+ import { type ChargeParams, type ChargeResult, type CosignedTap, type ResumeChargeParams } from "./charge.js";
6
+ import { type DeferredQueueStore } from "./deferred-store.js";
7
+ export interface MerchantClientConfig {
8
+ rpc: SdkRpc;
9
+ rpcSubscriptions?: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
10
+ merchant: Address;
11
+ provider: ProviderTransport | ProviderTransportConfig;
12
+ feePayer?: TransactionSigner;
13
+ treasurySigner?: TransactionSigner;
14
+ operator?: TransactionSigner;
15
+ rpId?: string;
16
+ tokenProgram?: Address;
17
+ deferredStore?: DeferredQueueStore;
18
+ autoFlush?: boolean;
19
+ flushIntervalMs?: number;
20
+ allowDeferral?: boolean;
21
+ }
22
+ export interface MerchantClient {
23
+ charge(params: ChargeParams): Promise<ChargeResult>;
24
+ resumeCharge(cosigned: CosignedTap, params?: ResumeChargeParams): Promise<ChargeResult>;
25
+ flushDeferred(): Promise<Signature[]>;
26
+ reconcileDeferred(): Promise<{
27
+ landed: number;
28
+ restored: number;
29
+ }>;
30
+ restoreDeferredFromProvider(): Promise<number>;
31
+ refund(params: {
32
+ payment: Address;
33
+ amount?: bigint;
34
+ }): Promise<{
35
+ signature: Signature;
36
+ refunded: bigint;
37
+ remaining: bigint;
38
+ }>;
39
+ respond(params: {
40
+ payment: Address;
41
+ evidenceHash: Uint8Array;
42
+ }): Promise<{
43
+ signature: Signature;
44
+ }>;
45
+ refundSettled(params: {
46
+ payer: Address;
47
+ mint: Address;
48
+ amount: bigint;
49
+ reference: Uint8Array;
50
+ originalPayment: Address;
51
+ merchantSigner?: TransactionSigner;
52
+ }): Promise<{
53
+ signature: Signature;
54
+ }>;
55
+ addOperator(operator: Address, options?: {
56
+ treasurySigner?: TransactionSigner;
57
+ }): Promise<{
58
+ signature: Signature;
59
+ }>;
60
+ removeOperator(operator: Address, options?: {
61
+ treasurySigner?: TransactionSigner;
62
+ }): Promise<{
63
+ signature: Signature;
64
+ }>;
65
+ getPayment(paymentOrSeeds: Address | {
66
+ payer: Address;
67
+ mint: Address;
68
+ reference: Uint8Array;
69
+ }): Promise<PaymentSummary | null>;
70
+ recentPayments(options?: {
71
+ limit?: number;
72
+ before?: Signature;
73
+ }): Promise<EventWithContext[]>;
74
+ onPayment(callback: (event: EventWithContext) => void, options?: {
75
+ onError?: (error: unknown) => void;
76
+ }): () => void;
77
+ }
78
+ export declare function createMerchantClient(config: MerchantClientConfig): MerchantClient;
79
+ export type { SdkRpc, Rpc, SolanaRpcApi };
80
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/merchant/client.ts"],"names":[],"mappings":"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"}