@ic-pay/icpay-sdk 1.4.93 → 1.4.103
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.
- package/README.md +26 -20
- package/dist/base-builder-code.d.ts +6 -0
- package/dist/base-builder-code.d.ts.map +1 -0
- package/dist/base-builder-code.js +50 -0
- package/dist/base-builder-code.js.map +1 -0
- package/dist/http.d.ts +9 -1
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +9 -0
- package/dist/http.js.map +1 -1
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +215 -105
- package/dist/index.js.map +1 -1
- package/dist/types/index.d.ts +58 -0
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +11 -8
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ICPay SDK
|
|
2
2
|
|
|
3
|
-
Official SDK for integrating Internet Computer
|
|
3
|
+
Official SDK for integrating **ICPay** — multi-chain crypto payments on **EVM (e.g. Base)**, **Solana**, and **Internet Computer**. Use one API for payment intents, USD or token amounts, wallet connection, balances, and advanced flows (X402, ATXP) across all supported chains.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -26,14 +26,15 @@ import Icpay from '@ic-pay/icpay-sdk';
|
|
|
26
26
|
|
|
27
27
|
const sdk = new Icpay({
|
|
28
28
|
publishableKey: process.env.NEXT_PUBLIC_ICPAY_PK!,
|
|
29
|
-
// Optional
|
|
29
|
+
// Optional: pass wallet providers for browser flows
|
|
30
30
|
evmProvider: (globalThis as any)?.ethereum,
|
|
31
|
+
solanaProvider: (globalThis as any)?.solana,
|
|
31
32
|
debug: false,
|
|
32
33
|
});
|
|
33
34
|
|
|
34
|
-
// Create a USD payment (amount in USD
|
|
35
|
+
// Create a USD payment (amount in USD; token/chain by shortcode, e.g. base_usdc, sol_usdc, ic_icp)
|
|
35
36
|
const tx = await sdk.createPaymentUsd({
|
|
36
|
-
tokenShortcode: '
|
|
37
|
+
tokenShortcode: 'base_usdc',
|
|
37
38
|
usdAmount: 5,
|
|
38
39
|
metadata: { orderId: 'ORDER-123' },
|
|
39
40
|
});
|
|
@@ -41,28 +42,34 @@ const tx = await sdk.createPaymentUsd({
|
|
|
41
42
|
console.log('Payment status:', tx.status);
|
|
42
43
|
```
|
|
43
44
|
|
|
45
|
+
## Supported chains
|
|
46
|
+
|
|
47
|
+
- **EVM** — Base (and other EVM chains): native and ERC‑20; automatic chain switching/addition hints.
|
|
48
|
+
- **Solana** — SOL and SPL tokens; Phantom, Backpack, and other Solana wallets.
|
|
49
|
+
- **Internet Computer** — ICP and ICRC tokens; Plug, Internet Identity, NFID, etc.
|
|
50
|
+
|
|
51
|
+
Use `tokenShortcode` (e.g. `base_usdc`, `sol_usdc`, `ic_icp`) or `ledgerCanisterId` to target a specific chain/token. Full list: `getVerifiedLedgers()` or [docs.icpay.org](https://docs.icpay.org).
|
|
52
|
+
|
|
44
53
|
## Features
|
|
45
54
|
|
|
46
|
-
-
|
|
47
|
-
- Create payment intents in USD or token amounts
|
|
48
|
-
- Multi-chain
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
- Advanced flows:
|
|
56
|
-
- X402: HTTP 402 workflow with verify, settle + fallbacks
|
|
57
|
-
- ATXP: quote/pay/execute
|
|
55
|
+
- **Keys** — Publishable key (browser-safe) and secret key (server-only) support.
|
|
56
|
+
- **Payments** — Create payment intents in USD or token amounts; relay to your EVM/IC/Solana addresses.
|
|
57
|
+
- **Multi-chain** — Single SDK for EVM (Base, etc.), Solana, and Internet Computer.
|
|
58
|
+
- **Wallet helpers** — Show connection modal, connect by provider, get providers, account address; WalletConnect QR and deep links.
|
|
59
|
+
- **Balances & prices** — External wallet balances, single-ledger balance, verified ledgers, all ledgers with prices.
|
|
60
|
+
- **Chain/ledger metadata** — `getChains()`, ledger info (decimals, prices, logos), token/chain filtering.
|
|
61
|
+
- **Events** — Lifecycle events: start/success/error and transaction events (e.g. `icpay-sdk-transaction-completed`).
|
|
62
|
+
- **Advanced flows** — **X402**: HTTP 402 sign-and-settle for IC, EVM, and Solana; **ATXP**: quote/pay/execute.
|
|
63
|
+
- **Onramp** — Optional fiat-to-crypto via Transak (configurable per account).
|
|
58
64
|
|
|
59
65
|
## Documentation
|
|
60
66
|
|
|
61
|
-
|
|
67
|
+
Full usage, configuration, API reference, and examples: **[https://docs.icpay.org](https://docs.icpay.org)**
|
|
68
|
+
Sandbox (testnets): **[betterstripe.com](https://betterstripe.com)** — Base Sepolia, Solana Devnet, and other test networks.
|
|
62
69
|
|
|
63
70
|
## AI agents
|
|
64
71
|
|
|
65
|
-
Using Cursor, Claude Code, Antigravity, Windsurf, Continue, GitHub Copilot, Kiro, or Trae
|
|
72
|
+
Using Cursor, Claude Code, Antigravity, Windsurf, Continue, GitHub Copilot, Kiro, or Trae with ICPay? Add the **ICPay skill** so the agent follows SDK, widget, payment links, and integration conventions.
|
|
66
73
|
|
|
67
74
|
### If the SDK is already in node_modules
|
|
68
75
|
|
|
@@ -78,7 +85,6 @@ Use the same pattern for other IDEs (`.claude/skills/`, `.agent/skills/`, etc.).
|
|
|
78
85
|
|
|
79
86
|
Run the **copy** commands below from the **icpay-sdk repo root** (after `git clone https://github.com/icpay/icpay-sdk && cd icpay-sdk`). If you can use symlinks, prefer symlinking so the skill stays updated on `git pull`; see "Where Cursor looks for skills" below.
|
|
80
87
|
|
|
81
|
-
|
|
82
88
|
| IDE / Agent | Where the skill goes | Copy command |
|
|
83
89
|
|-------------|----------------------|--------------|
|
|
84
90
|
| **Cursor** (project) | `.cursor/skills/icpay/` | `mkdir -p .cursor/skills && cp -r skills/icpay .cursor/skills/` |
|
|
@@ -98,4 +104,4 @@ Cursor, Claude Code, and Antigravity use the full skill folder; the others use `
|
|
|
98
104
|
## TypeScript
|
|
99
105
|
|
|
100
106
|
- Fully typed with bundled `.d.ts`
|
|
101
|
-
- Named exports include `IcpayError`, `IcpayWallet`, events and types
|
|
107
|
+
- Named exports include `IcpayError`, `IcpayWallet`, events, and types
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Appends the ICPay Base Builder Code to transaction data when the chain is Base.
|
|
3
|
+
* Use for EVM transactions (normal and x402) so activity is attributed on base.dev.
|
|
4
|
+
*/
|
|
5
|
+
export declare function appendBaseBuilderSuffixIfNeeded(chainId: string | number | null | undefined, data: string): string;
|
|
6
|
+
//# sourceMappingURL=base-builder-code.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"base-builder-code.d.ts","sourceRoot":"","sources":["../src/base-builder-code.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,IAAI,EAAE,MAAM,GACX,MAAM,CAUR"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.appendBaseBuilderSuffixIfNeeded = appendBaseBuilderSuffixIfNeeded;
|
|
4
|
+
/**
|
|
5
|
+
* Base Builder Code (ERC-8021) for transaction attribution on Base chain.
|
|
6
|
+
* @see https://docs.base.org/base-chain/builder-codes/app-developers
|
|
7
|
+
* @see https://www.erc8021.com/
|
|
8
|
+
*
|
|
9
|
+
* Suffix format: [CODES as ASCII hex] + [1 byte length] + [1 byte schema id] + [16 bytes 0x8021 marker]
|
|
10
|
+
*/
|
|
11
|
+
const ICPAY_BASE_BUILDER_CODE = 'bc_h549c0ug';
|
|
12
|
+
/** ERC-8021 16-byte marker at end of calldata (8× 0x8021) */
|
|
13
|
+
const ERC_8021_MARKER = '80218021802180218021802180218021';
|
|
14
|
+
function toHex(bytes) {
|
|
15
|
+
return Array.from(bytes)
|
|
16
|
+
.map((b) => b.toString(16).padStart(2, '0'))
|
|
17
|
+
.join('');
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Build ERC-8021 data suffix for Base Builder Code (Schema 0 canonical registry).
|
|
21
|
+
*/
|
|
22
|
+
function getBaseDataSuffixHex() {
|
|
23
|
+
const codesBytes = new TextEncoder().encode(ICPAY_BASE_BUILDER_CODE);
|
|
24
|
+
const lengthByte = codesBytes.length;
|
|
25
|
+
const schemaId = 0; // Schema 0 = canonical registry
|
|
26
|
+
return (toHex(codesBytes) +
|
|
27
|
+
lengthByte.toString(16).padStart(2, '0') +
|
|
28
|
+
schemaId.toString(16).padStart(2, '0') +
|
|
29
|
+
ERC_8021_MARKER);
|
|
30
|
+
}
|
|
31
|
+
const BASE_DATA_SUFFIX_HEX = getBaseDataSuffixHex();
|
|
32
|
+
/** Base mainnet and Base Sepolia chain IDs */
|
|
33
|
+
const BASE_CHAIN_IDS = new Set([8453, 84532]);
|
|
34
|
+
/**
|
|
35
|
+
* Appends the ICPay Base Builder Code to transaction data when the chain is Base.
|
|
36
|
+
* Use for EVM transactions (normal and x402) so activity is attributed on base.dev.
|
|
37
|
+
*/
|
|
38
|
+
function appendBaseBuilderSuffixIfNeeded(chainId, data) {
|
|
39
|
+
const c = chainId == null
|
|
40
|
+
? null
|
|
41
|
+
: typeof chainId === 'string'
|
|
42
|
+
? parseInt(chainId, 10)
|
|
43
|
+
: chainId;
|
|
44
|
+
if (c == null || !Number.isFinite(c) || !BASE_CHAIN_IDS.has(c))
|
|
45
|
+
return data;
|
|
46
|
+
if (!data || typeof data !== 'string')
|
|
47
|
+
return data;
|
|
48
|
+
return data + BASE_DATA_SUFFIX_HEX;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=base-builder-code.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"base-builder-code.js","sourceRoot":"","sources":["../src/base-builder-code.ts"],"names":[],"mappings":";;AA0CA,0EAaC;AAvDD;;;;;;GAMG;AACH,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAE9C,6DAA6D;AAC7D,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAE3D,SAAS,KAAK,CAAC,KAAiB;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB;IAC3B,MAAM,UAAU,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,gCAAgC;IACpD,OAAO,CACL,KAAK,CAAC,UAAU,CAAC;QACjB,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACtC,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAE9C;;;GAGG;AACH,SAAgB,+BAA+B,CAC7C,OAA2C,EAC3C,IAAY;IAEZ,MAAM,CAAC,GACL,OAAO,IAAI,IAAI;QACb,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC;IAChB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,IAAI,GAAG,oBAAoB,CAAC;AACrC,CAAC"}
|
package/dist/http.d.ts
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
export type RequestHeaders = Record<string, string>;
|
|
2
|
-
|
|
2
|
+
/** Public API contract for the HTTP client (get, post, patch). */
|
|
3
|
+
export interface IHttpClient {
|
|
4
|
+
get<T = any>(path: string, headers?: RequestHeaders): Promise<T>;
|
|
5
|
+
post<T = any>(path: string, body?: any, headers?: RequestHeaders): Promise<T>;
|
|
6
|
+
patch<T = any>(path: string, body?: any, headers?: RequestHeaders): Promise<T>;
|
|
7
|
+
setHeader(name: string, value: string | undefined): void;
|
|
8
|
+
}
|
|
9
|
+
export declare class HttpClient implements IHttpClient {
|
|
3
10
|
private baseURL;
|
|
4
11
|
private defaultHeaders;
|
|
5
12
|
constructor(options: {
|
|
@@ -9,6 +16,7 @@ export declare class HttpClient {
|
|
|
9
16
|
setHeader(name: string, value: string | undefined): void;
|
|
10
17
|
get<T = any>(path: string, headers?: RequestHeaders): Promise<T>;
|
|
11
18
|
post<T = any>(path: string, body?: any, headers?: RequestHeaders): Promise<T>;
|
|
19
|
+
patch<T = any>(path: string, body?: any, headers?: RequestHeaders): Promise<T>;
|
|
12
20
|
private resolve;
|
|
13
21
|
private handleResponse;
|
|
14
22
|
}
|
package/dist/http.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,qBAAa,
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CAC1D;AAED,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE;IAKlE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAQ3C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAShE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAU7E,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAUpF,OAAO,CAAC,OAAO;YAKD,cAAc;CAY7B"}
|
package/dist/http.js
CHANGED
|
@@ -31,6 +31,15 @@ class HttpClient {
|
|
|
31
31
|
});
|
|
32
32
|
return this.handleResponse(res);
|
|
33
33
|
}
|
|
34
|
+
async patch(path, body, headers) {
|
|
35
|
+
const url = this.resolve(path);
|
|
36
|
+
const res = await fetch(url, {
|
|
37
|
+
method: 'PATCH',
|
|
38
|
+
headers: { ...this.defaultHeaders, ...(headers || {}) },
|
|
39
|
+
body: body === undefined ? undefined : JSON.stringify(body),
|
|
40
|
+
});
|
|
41
|
+
return this.handleResponse(res);
|
|
42
|
+
}
|
|
34
43
|
resolve(path) {
|
|
35
44
|
if (/^https?:\/\//i.test(path))
|
|
36
45
|
return path;
|
package/dist/http.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -25,6 +25,8 @@ export declare class Icpay {
|
|
|
25
25
|
canisterTxId?: number;
|
|
26
26
|
transactionId?: string;
|
|
27
27
|
orderId?: string;
|
|
28
|
+
/** When paying with an existing intent on a payment link page, pass link context so the intent is linked. */
|
|
29
|
+
icpayPaymentLink?: Record<string, unknown>;
|
|
28
30
|
}): Promise<{
|
|
29
31
|
paymentId: string | null;
|
|
30
32
|
paymentIntentId: string | null;
|
|
@@ -172,6 +174,11 @@ export declare class Icpay {
|
|
|
172
174
|
*/
|
|
173
175
|
getLedgerBalance(ledgerCanisterId: string): Promise<bigint>;
|
|
174
176
|
private createPackedMemo;
|
|
177
|
+
/**
|
|
178
|
+
* Resolve payment intent from config or request: use full intent if provided, else fetch by id via API.
|
|
179
|
+
* Returns null when no pre-provided intent (caller should create via POST).
|
|
180
|
+
*/
|
|
181
|
+
private getOrResolvePaymentIntent;
|
|
175
182
|
/**
|
|
176
183
|
* Create a payment to a specific canister/ledger (public method)
|
|
177
184
|
* This is now a real transaction
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|