@asgcard/pay 0.1.1

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 (76) hide show
  1. package/CHANGELOG.md +90 -0
  2. package/LICENSE +21 -0
  3. package/README.md +393 -0
  4. package/dist/cjs/adapters/base.js +174 -0
  5. package/dist/cjs/adapters/base.js.map +1 -0
  6. package/dist/cjs/adapters/evm.js +263 -0
  7. package/dist/cjs/adapters/evm.js.map +1 -0
  8. package/dist/cjs/adapters/index.js +13 -0
  9. package/dist/cjs/adapters/index.js.map +1 -0
  10. package/dist/cjs/adapters/stellar.js +173 -0
  11. package/dist/cjs/adapters/stellar.js.map +1 -0
  12. package/dist/cjs/adapters/stripe.js +338 -0
  13. package/dist/cjs/adapters/stripe.js.map +1 -0
  14. package/dist/cjs/adapters/types.js +3 -0
  15. package/dist/cjs/adapters/types.js.map +1 -0
  16. package/dist/cjs/client.js +309 -0
  17. package/dist/cjs/client.js.map +1 -0
  18. package/dist/cjs/index.js +36 -0
  19. package/dist/cjs/index.js.map +1 -0
  20. package/dist/cjs/logger.js +7 -0
  21. package/dist/cjs/logger.js.map +1 -0
  22. package/dist/cjs/mpp.js +187 -0
  23. package/dist/cjs/mpp.js.map +1 -0
  24. package/dist/cjs/policy.js +71 -0
  25. package/dist/cjs/policy.js.map +1 -0
  26. package/dist/cjs/stellar.js +87 -0
  27. package/dist/cjs/stellar.js.map +1 -0
  28. package/dist/esm/adapters/base.js +170 -0
  29. package/dist/esm/adapters/base.js.map +1 -0
  30. package/dist/esm/adapters/evm.js +258 -0
  31. package/dist/esm/adapters/evm.js.map +1 -0
  32. package/dist/esm/adapters/index.js +5 -0
  33. package/dist/esm/adapters/index.js.map +1 -0
  34. package/dist/esm/adapters/stellar.js +136 -0
  35. package/dist/esm/adapters/stellar.js.map +1 -0
  36. package/dist/esm/adapters/stripe.js +334 -0
  37. package/dist/esm/adapters/stripe.js.map +1 -0
  38. package/dist/esm/adapters/types.js +2 -0
  39. package/dist/esm/adapters/types.js.map +1 -0
  40. package/dist/esm/client.js +302 -0
  41. package/dist/esm/client.js.map +1 -0
  42. package/dist/esm/index.js +16 -0
  43. package/dist/esm/index.js.map +1 -0
  44. package/dist/esm/logger.js +3 -0
  45. package/dist/esm/logger.js.map +1 -0
  46. package/dist/esm/mpp.js +175 -0
  47. package/dist/esm/mpp.js.map +1 -0
  48. package/dist/esm/policy.js +67 -0
  49. package/dist/esm/policy.js.map +1 -0
  50. package/dist/esm/stellar.js +50 -0
  51. package/dist/esm/stellar.js.map +1 -0
  52. package/dist/types/adapters/base.d.ts +53 -0
  53. package/dist/types/adapters/base.d.ts.map +1 -0
  54. package/dist/types/adapters/evm.d.ts +81 -0
  55. package/dist/types/adapters/evm.d.ts.map +1 -0
  56. package/dist/types/adapters/index.d.ts +6 -0
  57. package/dist/types/adapters/index.d.ts.map +1 -0
  58. package/dist/types/adapters/stellar.d.ts +67 -0
  59. package/dist/types/adapters/stellar.d.ts.map +1 -0
  60. package/dist/types/adapters/stripe.d.ts +206 -0
  61. package/dist/types/adapters/stripe.d.ts.map +1 -0
  62. package/dist/types/adapters/types.d.ts +35 -0
  63. package/dist/types/adapters/types.d.ts.map +1 -0
  64. package/dist/types/client.d.ts +89 -0
  65. package/dist/types/client.d.ts.map +1 -0
  66. package/dist/types/index.d.ts +15 -0
  67. package/dist/types/index.d.ts.map +1 -0
  68. package/dist/types/logger.d.ts +10 -0
  69. package/dist/types/logger.d.ts.map +1 -0
  70. package/dist/types/mpp.d.ts +153 -0
  71. package/dist/types/mpp.d.ts.map +1 -0
  72. package/dist/types/policy.d.ts +40 -0
  73. package/dist/types/policy.d.ts.map +1 -0
  74. package/dist/types/stellar.d.ts +27 -0
  75. package/dist/types/stellar.d.ts.map +1 -0
  76. package/package.json +86 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,263 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.EvmPaymentAdapter = void 0;
4
+ exports.listEvmChains = listEvmChains;
5
+ const viem_1 = require("viem");
6
+ const accounts_1 = require("viem/accounts");
7
+ const chains_1 = require("viem/chains");
8
+ const logger_1 = require("../logger");
9
+ /**
10
+ * Chain registry — maps chain names to viem chain objects + USDC contracts.
11
+ * All USDC addresses are Circle's official native USDC deployments.
12
+ */
13
+ const CHAIN_REGISTRY = {
14
+ // ── Base (Coinbase L2) ──────────────────────────────────────────
15
+ 'base': {
16
+ chain: chains_1.base,
17
+ displayName: 'Base',
18
+ usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
19
+ },
20
+ 'base-sepolia': {
21
+ chain: chains_1.baseSepolia,
22
+ displayName: 'Base Sepolia',
23
+ usdc: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
24
+ },
25
+ // ── Arbitrum ────────────────────────────────────────────────────
26
+ 'arbitrum': {
27
+ chain: chains_1.arbitrum,
28
+ displayName: 'Arbitrum One',
29
+ usdc: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
30
+ },
31
+ 'arbitrum-sepolia': {
32
+ chain: chains_1.arbitrumSepolia,
33
+ displayName: 'Arbitrum Sepolia',
34
+ usdc: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
35
+ },
36
+ // ── Optimism ────────────────────────────────────────────────────
37
+ 'optimism': {
38
+ chain: chains_1.optimism,
39
+ displayName: 'Optimism',
40
+ usdc: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
41
+ },
42
+ 'optimism-sepolia': {
43
+ chain: chains_1.optimismSepolia,
44
+ displayName: 'Optimism Sepolia',
45
+ usdc: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
46
+ },
47
+ // ── Ethereum ────────────────────────────────────────────────────
48
+ 'ethereum': {
49
+ chain: chains_1.mainnet,
50
+ displayName: 'Ethereum',
51
+ usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
52
+ },
53
+ 'ethereum-sepolia': {
54
+ chain: chains_1.sepolia,
55
+ displayName: 'Ethereum Sepolia',
56
+ usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
57
+ },
58
+ // ── Polygon ─────────────────────────────────────────────────────
59
+ 'polygon': {
60
+ chain: chains_1.polygon,
61
+ displayName: 'Polygon',
62
+ usdc: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
63
+ },
64
+ 'polygon-amoy': {
65
+ chain: chains_1.polygonAmoy,
66
+ displayName: 'Polygon Amoy',
67
+ usdc: null, // No official Circle testnet USDC on Amoy yet
68
+ },
69
+ };
70
+ // ─── ERC-20 ABI (minimal) ───────────────────────────────────────────
71
+ const ERC20_ABI = [
72
+ {
73
+ name: 'transfer',
74
+ type: 'function',
75
+ stateMutability: 'nonpayable',
76
+ inputs: [
77
+ { name: 'to', type: 'address' },
78
+ { name: 'amount', type: 'uint256' },
79
+ ],
80
+ outputs: [{ name: '', type: 'bool' }],
81
+ },
82
+ {
83
+ name: 'balanceOf',
84
+ type: 'function',
85
+ stateMutability: 'view',
86
+ inputs: [{ name: 'account', type: 'address' }],
87
+ outputs: [{ name: '', type: 'uint256' }],
88
+ },
89
+ ];
90
+ // ─── Universal EVM Adapter ──────────────────────────────────────────
91
+ /**
92
+ * EvmPaymentAdapter — Universal EVM on-chain settlement.
93
+ *
94
+ * One adapter for ALL EVM chains supported by x402:
95
+ * Base, Arbitrum, Optimism, Ethereum, Polygon — mainnet & testnet.
96
+ *
97
+ * Supports native token (ETH/MATIC) and USDC (Circle ERC-20) transfers.
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * // Arbitrum USDC settlement
102
+ * const adapter = new EvmPaymentAdapter({
103
+ * chain: 'arbitrum',
104
+ * asset: 'USDC',
105
+ * privateKey: '0x...',
106
+ * });
107
+ *
108
+ * // Base ETH settlement (testnet)
109
+ * const adapter = new EvmPaymentAdapter({
110
+ * chain: 'base-sepolia',
111
+ * asset: 'native',
112
+ * });
113
+ * ```
114
+ *
115
+ * @see https://x402.org — x402 payment protocol
116
+ * @see https://pay.asgcard.dev — ASG Pay production infrastructure
117
+ */
118
+ class EvmPaymentAdapter {
119
+ chainName;
120
+ caip2Id;
121
+ wallet;
122
+ publicClient;
123
+ account;
124
+ chainConfig;
125
+ asset;
126
+ log;
127
+ constructor(options) {
128
+ const config = CHAIN_REGISTRY[options.chain];
129
+ if (!config) {
130
+ throw new Error(`Unsupported chain: "${options.chain}". ` +
131
+ `Supported: ${Object.keys(CHAIN_REGISTRY).join(', ')}`);
132
+ }
133
+ this.chainConfig = config;
134
+ this.chainName = config.displayName;
135
+ this.caip2Id = `eip155:${config.chain.id}`;
136
+ this.asset = options.asset ?? 'native';
137
+ this.log = options.logger ?? logger_1.noopLogger;
138
+ if (this.asset === 'USDC' && !config.usdc) {
139
+ throw new Error(`No USDC contract available for ${config.displayName}. ` +
140
+ `Use asset: 'native' or choose a chain with USDC support.`);
141
+ }
142
+ const key = options.privateKey ?? (0, accounts_1.generatePrivateKey)();
143
+ this.account = (0, accounts_1.privateKeyToAccount)(key);
144
+ const transport = options.rpcUrl ? (0, viem_1.http)(options.rpcUrl) : (0, viem_1.http)();
145
+ this.wallet = (0, viem_1.createWalletClient)({
146
+ account: this.account,
147
+ chain: config.chain,
148
+ transport,
149
+ });
150
+ this.publicClient = (0, viem_1.createPublicClient)({
151
+ chain: config.chain,
152
+ transport,
153
+ });
154
+ }
155
+ getAddress() {
156
+ return this.account.address;
157
+ }
158
+ /** Get native token balance (ETH, MATIC, etc.). */
159
+ async getNativeBalance() {
160
+ const balance = await this.publicClient.getBalance({
161
+ address: this.account.address,
162
+ });
163
+ return (0, viem_1.formatEther)(balance);
164
+ }
165
+ /** Get USDC balance (6 decimals). Returns '0.00' if USDC not supported. */
166
+ async getUsdcBalance() {
167
+ const usdcAddress = this.chainConfig.usdc;
168
+ if (!usdcAddress)
169
+ return '0.00';
170
+ const balance = await this.publicClient.readContract({
171
+ address: usdcAddress,
172
+ abi: ERC20_ABI,
173
+ functionName: 'balanceOf',
174
+ args: [this.account.address],
175
+ });
176
+ return (0, viem_1.formatUnits)(balance, 6);
177
+ }
178
+ async pay(destination, amount, network) {
179
+ if (this.asset === 'USDC') {
180
+ return this.payUsdc(destination, amount);
181
+ }
182
+ return this.payNative(destination, amount);
183
+ }
184
+ // ── Native token transfer ───────────────────────────────────────
185
+ async payNative(destination, amount) {
186
+ const tag = `[${this.chainName}/native]`;
187
+ try {
188
+ const amountWei = BigInt(amount);
189
+ const formatted = (0, viem_1.formatEther)(amountWei);
190
+ this.log(`${tag} 🚀 ${formatted} → ${this.shortAddr(destination)}`);
191
+ const balance = await this.publicClient.getBalance({
192
+ address: this.account.address,
193
+ });
194
+ if (balance < amountWei) {
195
+ this.log(`${tag} ❌ Insufficient: ${(0, viem_1.formatEther)(balance)} < ${formatted}`);
196
+ return null;
197
+ }
198
+ const hash = await this.wallet.sendTransaction({
199
+ account: this.account,
200
+ to: destination,
201
+ value: amountWei,
202
+ chain: this.chainConfig.chain,
203
+ });
204
+ this.log(`${tag} ✅ ${hash}`);
205
+ return hash;
206
+ }
207
+ catch (error) {
208
+ this.log(`${tag} ❌ ${error.message}`);
209
+ return null;
210
+ }
211
+ }
212
+ // ── USDC ERC-20 transfer ────────────────────────────────────────
213
+ async payUsdc(destination, amount) {
214
+ const tag = `[${this.chainName}/USDC]`;
215
+ const usdcAddress = this.chainConfig.usdc;
216
+ try {
217
+ const amountAtomic = BigInt(amount);
218
+ const formatted = (0, viem_1.formatUnits)(amountAtomic, 6);
219
+ this.log(`${tag} 🚀 ${formatted} USDC → ${this.shortAddr(destination)}`);
220
+ // Balance check
221
+ const balance = await this.publicClient.readContract({
222
+ address: usdcAddress,
223
+ abi: ERC20_ABI,
224
+ functionName: 'balanceOf',
225
+ args: [this.account.address],
226
+ });
227
+ if (balance < amountAtomic) {
228
+ this.log(`${tag} ❌ Insufficient: ${(0, viem_1.formatUnits)(balance, 6)} < ${formatted} USDC`);
229
+ return null;
230
+ }
231
+ const hash = await this.wallet.writeContract({
232
+ address: usdcAddress,
233
+ abi: ERC20_ABI,
234
+ functionName: 'transfer',
235
+ args: [destination, amountAtomic],
236
+ chain: this.chainConfig.chain,
237
+ account: this.account,
238
+ });
239
+ this.log(`${tag} ✅ ${hash}`);
240
+ return hash;
241
+ }
242
+ catch (error) {
243
+ this.log(`${tag} ❌ ${error.message}`);
244
+ return null;
245
+ }
246
+ }
247
+ shortAddr(addr) {
248
+ return `${addr.slice(0, 8)}…${addr.slice(-6)}`;
249
+ }
250
+ }
251
+ exports.EvmPaymentAdapter = EvmPaymentAdapter;
252
+ // ─── Helper: list all supported chains ──────────────────────────────
253
+ /** Returns metadata for all supported EVM chains. */
254
+ function listEvmChains() {
255
+ return Object.entries(CHAIN_REGISTRY).map(([name, config]) => ({
256
+ name: name,
257
+ displayName: config.displayName,
258
+ chainId: config.chain.id,
259
+ caip2Id: `eip155:${config.chain.id}`,
260
+ hasUsdc: config.usdc !== null,
261
+ }));
262
+ }
263
+ //# sourceMappingURL=evm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evm.js","sourceRoot":"","sources":["../../../src/adapters/evm.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StellarPaymentAdapter = exports.BasePaymentAdapter = exports.StripePaymentAdapter = exports.listEvmChains = exports.EvmPaymentAdapter = void 0;
4
+ var evm_1 = require("./evm");
5
+ Object.defineProperty(exports, "EvmPaymentAdapter", { enumerable: true, get: function () { return evm_1.EvmPaymentAdapter; } });
6
+ Object.defineProperty(exports, "listEvmChains", { enumerable: true, get: function () { return evm_1.listEvmChains; } });
7
+ var stripe_1 = require("./stripe");
8
+ Object.defineProperty(exports, "StripePaymentAdapter", { enumerable: true, get: function () { return stripe_1.StripePaymentAdapter; } });
9
+ var base_1 = require("./base");
10
+ Object.defineProperty(exports, "BasePaymentAdapter", { enumerable: true, get: function () { return base_1.BasePaymentAdapter; } });
11
+ var stellar_1 = require("./stellar");
12
+ Object.defineProperty(exports, "StellarPaymentAdapter", { enumerable: true, get: function () { return stellar_1.StellarPaymentAdapter; } });
13
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":";;;AACA,6BAA0F;AAAjF,wGAAA,iBAAiB,OAAA;AAAmC,oGAAA,aAAa,OAAA;AAC1E,mCAAsE;AAA7D,8GAAA,oBAAoB,OAAA;AAC7B,+BAAgE;AAAvD,0GAAA,kBAAkB,OAAA;AAC3B,qCAAgF;AAAvE,gHAAA,qBAAqB,OAAA"}
@@ -0,0 +1,173 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.StellarPaymentAdapter = void 0;
37
+ const StellarSdk = __importStar(require("@stellar/stellar-sdk"));
38
+ const logger_1 = require("../logger");
39
+ /** Circle's official USDC issuer on Stellar mainnet. */
40
+ const USDC_ISSUER = 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN';
41
+ /**
42
+ * StellarPaymentAdapter — On-chain settlement on the Stellar network.
43
+ *
44
+ * Supports:
45
+ * - Native XLM payments (testnet default)
46
+ * - Circle USDC payments (production recommended)
47
+ *
48
+ * The production ASG Pay stack settles USDC on Stellar mainnet.
49
+ * @see https://pay.asgcard.dev
50
+ * @see https://stellar.org/usdc
51
+ */
52
+ class StellarPaymentAdapter {
53
+ chainName = 'Stellar';
54
+ caip2Id;
55
+ keypair;
56
+ server;
57
+ networkPassphrase;
58
+ assetType;
59
+ log;
60
+ constructor(options) {
61
+ this.keypair = StellarSdk.Keypair.fromSecret(options.secretKey);
62
+ this.log = options.logger ?? logger_1.noopLogger;
63
+ this.assetType = options.asset ?? 'XLM';
64
+ const isMainnet = options.network === 'mainnet';
65
+ this.networkPassphrase = isMainnet
66
+ ? StellarSdk.Networks.PUBLIC
67
+ : StellarSdk.Networks.TESTNET;
68
+ this.caip2Id = isMainnet ? 'stellar:pubnet' : 'stellar:testnet';
69
+ this.server = new StellarSdk.Horizon.Server(options.horizonUrl ??
70
+ (isMainnet
71
+ ? 'https://horizon.stellar.org'
72
+ : 'https://horizon-testnet.stellar.org'));
73
+ }
74
+ getAddress() {
75
+ return this.keypair.publicKey();
76
+ }
77
+ /**
78
+ * Get the Stellar asset object based on configuration.
79
+ * - XLM: native asset (no trustline needed)
80
+ * - USDC: Circle's issued USDC (trustline required)
81
+ */
82
+ getAsset() {
83
+ if (this.assetType === 'USDC') {
84
+ return new StellarSdk.Asset('USDC', USDC_ISSUER);
85
+ }
86
+ return StellarSdk.Asset.native();
87
+ }
88
+ /**
89
+ * Convert atomic units to human-readable amount.
90
+ * Stellar uses 7 decimal places (stroops) for all assets.
91
+ */
92
+ formatAmount(stroops) {
93
+ return (parseInt(stroops, 10) / 1e7).toFixed(7);
94
+ }
95
+ async pay(destination, amount, network) {
96
+ try {
97
+ const asset = this.getAsset();
98
+ const humanAmount = this.formatAmount(amount);
99
+ const assetLabel = this.assetType === 'USDC' ? 'USDC' : 'XLM';
100
+ this.log(`[Stellar/${assetLabel}] 🚀 ${humanAmount} → ${destination.slice(0, 10)}…`);
101
+ const sourceAccount = await this.server.loadAccount(this.keypair.publicKey());
102
+ const tx = new StellarSdk.TransactionBuilder(sourceAccount, {
103
+ fee: StellarSdk.BASE_FEE,
104
+ networkPassphrase: this.networkPassphrase,
105
+ })
106
+ .addOperation(StellarSdk.Operation.payment({
107
+ destination,
108
+ asset,
109
+ amount: humanAmount,
110
+ }))
111
+ .setTimeout(30)
112
+ .build();
113
+ tx.sign(this.keypair);
114
+ this.log(`[Stellar/${assetLabel}] 📡 Submitting…`);
115
+ const response = await this.server.submitTransaction(tx);
116
+ this.log(`[Stellar/${assetLabel}] ✅ ${response.hash}`);
117
+ return response.hash;
118
+ }
119
+ catch (error) {
120
+ const detail = error?.response?.data?.extras?.result_codes || error.message;
121
+ this.log(`[Stellar] ❌ ${JSON.stringify(detail)}`);
122
+ return null;
123
+ }
124
+ }
125
+ /**
126
+ * Check if the account has a USDC trustline.
127
+ * Returns false if using XLM or if the trustline exists.
128
+ * Returns true if USDC is selected but trustline is missing.
129
+ */
130
+ async needsTrustline() {
131
+ if (this.assetType !== 'USDC')
132
+ return false;
133
+ try {
134
+ const account = await this.server.loadAccount(this.keypair.publicKey());
135
+ const hasTrustline = account.balances.some((b) => b.asset_type !== 'native' &&
136
+ b.asset_code === 'USDC' &&
137
+ b.asset_issuer === USDC_ISSUER);
138
+ return !hasTrustline;
139
+ }
140
+ catch {
141
+ return true;
142
+ }
143
+ }
144
+ /**
145
+ * Establish a USDC trustline (required before receiving USDC).
146
+ * Only needed once per account.
147
+ */
148
+ async createUsdcTrustline() {
149
+ try {
150
+ this.log('[Stellar/USDC] 🔗 Creating USDC trustline…');
151
+ const sourceAccount = await this.server.loadAccount(this.keypair.publicKey());
152
+ const tx = new StellarSdk.TransactionBuilder(sourceAccount, {
153
+ fee: StellarSdk.BASE_FEE,
154
+ networkPassphrase: this.networkPassphrase,
155
+ })
156
+ .addOperation(StellarSdk.Operation.changeTrust({
157
+ asset: new StellarSdk.Asset('USDC', USDC_ISSUER),
158
+ }))
159
+ .setTimeout(30)
160
+ .build();
161
+ tx.sign(this.keypair);
162
+ const response = await this.server.submitTransaction(tx);
163
+ this.log(`[Stellar/USDC] ✅ Trustline created: ${response.hash}`);
164
+ return response.hash;
165
+ }
166
+ catch (error) {
167
+ this.log(`[Stellar/USDC] ❌ Trustline failed: ${error.message}`);
168
+ return null;
169
+ }
170
+ }
171
+ }
172
+ exports.StellarPaymentAdapter = StellarPaymentAdapter;
173
+ //# sourceMappingURL=stellar.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stellar.js","sourceRoot":"","sources":["../../../src/adapters/stellar.ts"],"names":[],"mappings":"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"}