@shapeshiftoss/utils 1.1.1 → 1.2.0

package/dist/cjs/index.d.ts

@@ -15,6 +15,8 @@ export * from './getChainShortName';
 export * from './getNativeFeeAssetReference';
 export * from './historyTimeframe';
 export * from './makeAsset/makeAsset';
+export * from './paymentUri/constants';
+export * from './paymentUri/paymentUri';
 export * from './promises';
 export * from './sha256';
 export * from './timeout';

package/dist/cjs/index.js

@@ -33,6 +33,8 @@ __exportStar(require("./getChainShortName"), exports);
 __exportStar(require("./getNativeFeeAssetReference"), exports);
 __exportStar(require("./historyTimeframe"), exports);
 __exportStar(require("./makeAsset/makeAsset"), exports);
+__exportStar(require("./paymentUri/constants"), exports);
+__exportStar(require("./paymentUri/paymentUri"), exports);
 __exportStar(require("./promises"), exports);
 __exportStar(require("./sha256"), exports);
 __exportStar(require("./timeout"), exports);

package/dist/cjs/paymentUri/constants.d.ts

@@ -0,0 +1,3 @@
+import type { ChainId } from '@shapeshiftoss/caip';
+export declare const CHAIN_ID_TO_URN_SCHEME: Partial<Record<ChainId, string>>;
+export declare const URN_SCHEME_TO_CHAIN_ID: Partial<Record<string, ChainId>>;

package/dist/cjs/paymentUri/constants.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URN_SCHEME_TO_CHAIN_ID = exports.CHAIN_ID_TO_URN_SCHEME = void 0;
+const caip_1 = require("@shapeshiftoss/caip");
+exports.CHAIN_ID_TO_URN_SCHEME = {
+    [caip_1.ethChainId]: 'ethereum',
+    [caip_1.arbitrumChainId]: 'arbitrum',
+    [caip_1.optimismChainId]: 'optimism',
+    [caip_1.polygonChainId]: 'polygon',
+    [caip_1.bscChainId]: 'smartchain',
+    [caip_1.avalancheChainId]: 'avalanchec',
+    [caip_1.baseChainId]: 'base',
+    [caip_1.gnosisChainId]: 'xdai',
+    [caip_1.btcChainId]: 'bitcoin',
+    [caip_1.bchChainId]: 'bitcoincash',
+    [caip_1.dogeChainId]: 'dogecoin',
+    [caip_1.ltcChainId]: 'litecoin',
+    [caip_1.zecChainId]: 'zcash',
+    [caip_1.thorchainChainId]: 'thorchain',
+    [caip_1.cosmosChainId]: 'cosmos',
+    [caip_1.mayachainChainId]: 'mayachain',
+    [caip_1.solanaChainId]: 'solana',
+    [caip_1.tronChainId]: 'tron',
+};
+exports.URN_SCHEME_TO_CHAIN_ID = {
+    ...Object.fromEntries(Object.entries(exports.CHAIN_ID_TO_URN_SCHEME).map(([chainId, scheme]) => [scheme, chainId])),
+    // The app emitted doge: QR codes for a year before adopting Dogecoin Core's scheme
+    doge: caip_1.dogeChainId,
+};

package/dist/cjs/paymentUri/paymentUri.d.ts

@@ -0,0 +1,7 @@
+import type { Asset } from '@shapeshiftoss/types';
+export type BuildPaymentUriArgs = {
+    address: string;
+    asset: Pick<Asset, 'assetId' | 'chainId' | 'precision'>;
+    amountCryptoPrecision?: string;
+};
+export declare const buildPaymentUri: (args: BuildPaymentUriArgs) => string;

package/dist/cjs/paymentUri/paymentUri.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPaymentUri = void 0;
+const caip_1 = require("@shapeshiftoss/caip");
+const bigAmount_1 = require("../bigAmount/bigAmount");
+const bignumber_1 = require("../bignumber/bignumber");
+const constants_1 = require("./constants");
+const toBaseUnit = (asset, amountCryptoPrecision) => bigAmount_1.BigAmount.fromPrecision({ value: amountCryptoPrecision, precision: asset.precision }).toBaseUnit();
+// EIP-681 encourages scientific notation, and writes it without the exponent's plus sign
+const toEip681Amount = (amountCryptoBaseUnit) => (0, bignumber_1.bn)(amountCryptoBaseUnit).toExponential().replace('+', '').replace('e0', '');
+const buildEvmUri = ({ address, asset, amountCryptoPrecision }) => {
+    const target = `@${Number((0, caip_1.fromChainId)(asset.chainId).chainReference)}`;
+    const { assetNamespace, assetReference } = (0, caip_1.fromAssetId)(asset.assetId);
+    // transfer(address,uint256) is erc20's alone, so erc721 and erc1155 get no amount
+    const takesAmount = assetNamespace === caip_1.ASSET_NAMESPACE.slip44 || assetNamespace === caip_1.ASSET_NAMESPACE.erc20;
+    if (!amountCryptoPrecision || !takesAmount)
+        return `ethereum:${address}${target}`;
+    const amount = toEip681Amount(toBaseUnit(asset, amountCryptoPrecision));
+    return assetNamespace === caip_1.ASSET_NAMESPACE.erc20
+        ? `ethereum:${assetReference}${target}/transfer?address=${address}&uint256=${amount}`
+        : `ethereum:${address}${target}?value=${amount}`;
+};
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+// The same check as web3.js's PublicKey: base58 that decodes to exactly 32 bytes
+const isSolanaPublicKey = (address) => {
+    let value = 0n;
+    for (const char of address) {
+        const digit = BASE58_ALPHABET.indexOf(char);
+        if (digit === -1)
+            return false;
+        value = value * 58n + BigInt(digit);
+    }
+    const leadingZeroBytes = address.length - address.replace(/^1+/, '').length;
+    const significantBytes = value === 0n ? 0 : Math.ceil(value.toString(16).length / 2);
+    return leadingZeroBytes + significantBytes === 32;
+};
+const buildSolanaUri = ({ address, asset, amountCryptoPrecision }) => {
+    if (!amountCryptoPrecision)
+        return address;
+    if (!isSolanaPublicKey(address))
+        throw new Error(`Invalid Solana address: ${address}`);
+    // Solana Pay normalises the amount rather than passing it through verbatim
+    const amount = (0, bignumber_1.bn)(amountCryptoPrecision).toFixed();
+    const { assetNamespace, assetReference } = (0, caip_1.fromAssetId)(asset.assetId);
+    if (assetNamespace === caip_1.ASSET_NAMESPACE.splToken) {
+        // Solana Pay takes decimal ui units, and the recipient is the native account, not its ATA
+        return `solana:${address}?amount=${amount}&spl-token=${assetReference}`;
+    }
+    return `solana:${address}?amount=${amount}`;
+};
+const buildTonUri = ({ address, asset, amountCryptoPrecision }) => {
+    if (!amountCryptoPrecision)
+        return address;
+    const { assetNamespace, assetReference } = (0, caip_1.fromAssetId)(asset.assetId);
+    const amount = toBaseUnit(asset, amountCryptoPrecision);
+    // A jetton transfer names its master contract, and its amount is in the jetton's own units
+    if (assetNamespace === caip_1.ASSET_NAMESPACE.jetton) {
+        return `ton://transfer/${address}?jetton=${assetReference}&amount=${amount}`;
+    }
+    return `ton://transfer/${address}?amount=${amount}`;
+};
+// BIP-21 takes decimal coin units
+const buildBip21Uri = ({ address, asset, amountCryptoPrecision }) => {
+    const scheme = constants_1.CHAIN_ID_TO_URN_SCHEME[asset.chainId];
+    if (!amountCryptoPrecision || !scheme)
+        return address;
+    // CashAddr already carries its scheme
+    const target = address.startsWith(`${scheme}:`) ? address.slice(scheme.length + 1) : address;
+    return `${scheme}:${target}?amount=${(0, bignumber_1.bn)(amountCryptoPrecision).toFixed()}`;
+};
+const buildPaymentUri = (args) => {
+    const { asset, amountCryptoPrecision } = args;
+    if (amountCryptoPrecision) {
+        const amount = (0, bignumber_1.bn)(amountCryptoPrecision);
+        if (!amount.isFinite() || amount.isNegative()) {
+            throw new Error(`Invalid payment amount: ${amountCryptoPrecision}`);
+        }
+        if ((amount.decimalPlaces() ?? 0) > asset.precision) {
+            throw new Error(`Payment amount ${amountCryptoPrecision} exceeds ${asset.precision} decimals`);
+        }
+    }
+    switch ((0, caip_1.fromChainId)(args.asset.chainId).chainNamespace) {
+        case caip_1.CHAIN_NAMESPACE.Utxo:
+        case caip_1.CHAIN_NAMESPACE.CosmosSdk:
+            return buildBip21Uri(args);
+        case caip_1.CHAIN_NAMESPACE.Evm:
+            return buildEvmUri(args);
+        case caip_1.CHAIN_NAMESPACE.Solana:
+            return buildSolanaUri(args);
+        case caip_1.CHAIN_NAMESPACE.Ton:
+            return buildTonUri(args);
+        default:
+            return args.address;
+    }
+};
+exports.buildPaymentUri = buildPaymentUri;

package/dist/cjs/paymentUri/paymentUri.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/paymentUri/paymentUri.test.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const paymentUri_1 = require("./paymentUri");
+const asset = (assetId, chainId, precision) => ({
+    assetId,
+    chainId,
+    precision,
+});
+const BTC = asset('bip122:000000000019d6689c085ae165831e93/slip44:0', 'bip122:000000000019d6689c085ae165831e93', 8);
+const BCH = asset('bip122:000000000000000000651ef99cb9fcbe/slip44:145', 'bip122:000000000000000000651ef99cb9fcbe', 8);
+const ETH = asset('eip155:1/slip44:60', 'eip155:1', 18);
+const BASE_ETH = asset('eip155:8453/slip44:60', 'eip155:8453', 18);
+const USDC = asset('eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', 'eip155:1', 6);
+const FOX = asset('eip155:1/erc20:0xc770eefad204b5180df6a14ee197d99d808ee52d', 'eip155:1', 18);
+const SOL = asset('solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501', 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp', 9);
+const WIF = asset('solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm', 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp', 6);
+const TON = asset('ton:mainnet/slip44:607', 'ton:mainnet', 9);
+const TON_USDT = asset('ton:mainnet/jetton:EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs', 'ton:mainnet', 6);
+const ATOM = asset('cosmos:cosmoshub-4/slip44:118', 'cosmos:cosmoshub-4', 6);
+const BTC_ADDRESS = 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzz';
+const EVM_ADDRESS = '0xAbC0000000000000000000000000000000000001';
+const SOL_ADDRESS = 'GsbwXfJraMomNxBcjYLcG3mxkBUiyWXAB32fGbSMQRdW';
+const TON_ADDRESS = 'UQBFtnj3-yYK4p7XqXsyC5LNxfL2Rm5m0m3F0pvfDy7YQ9tk';
+(0, vitest_1.describe)('buildPaymentUri', () => {
+    (0, vitest_1.it)('builds a BIP-21 uri with a decimal coin amount', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC, amountCryptoPrecision: '0.05' })).toBe(`bitcoin:${BTC_ADDRESS}?amount=0.05`);
+    });
+    (0, vitest_1.it)('does not double-prefix a cashaddr that already carries its scheme', () => {
+        const address = 'bitcoincash:qr95sy3j9xwd2ap32xkykttr4cvcu7as4y';
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address, asset: BCH, amountCryptoPrecision: '1' })).toBe('bitcoincash:qr95sy3j9xwd2ap32xkykttr4cvcu7as4y?amount=1');
+    });
+    (0, vitest_1.it)('carries the chain id so an l2 deposit cannot be paid on mainnet', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: BASE_ETH, amountCryptoPrecision: '2' })).toBe(`ethereum:${EVM_ADDRESS}@8453?value=2e18`);
+    });
+    (0, vitest_1.it)('targets the contract and moves the destination into the call for an erc20', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: USDC, amountCryptoPrecision: '1.5' })).toBe(`ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=${EVM_ADDRESS}&uint256=1.5e6`);
+    });
+    (0, vitest_1.it)('keeps every digit of a full-precision erc20 amount', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({
+            address: EVM_ADDRESS,
+            asset: FOX,
+            amountCryptoPrecision: '123.123456789012345678',
+        })).toBe(`ethereum:0xc770eefad204b5180df6a14ee197d99d808ee52d@1/transfer?address=${EVM_ADDRESS}&uint256=1.23123456789012345678e20`);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: USDC, amountCryptoPrecision: '0.000001' })).toBe(`ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=${EVM_ADDRESS}&uint256=1`);
+    });
+    (0, vitest_1.it)('builds a Solana Pay uri with ui units', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: SOL_ADDRESS, asset: SOL, amountCryptoPrecision: '1.5' })).toBe(`solana:${SOL_ADDRESS}?amount=1.5`);
+    });
+    (0, vitest_1.it)('names the mint and keeps the native account as recipient for an spl token', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: SOL_ADDRESS, asset: WIF, amountCryptoPrecision: '0.1' })).toBe(`solana:${SOL_ADDRESS}?amount=0.1&spl-token=EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm`);
+    });
+    (0, vitest_1.it)('builds a ton transfer link in nanotons', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: TON_ADDRESS, asset: TON, amountCryptoPrecision: '1.5' })).toBe(`ton://transfer/${TON_ADDRESS}?amount=1500000000`);
+    });
+    (0, vitest_1.it)('names the jetton master and uses the jetton units for a jetton', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: TON_ADDRESS, asset: TON_USDT, amountCryptoPrecision: '5' })).toBe(`ton://transfer/${TON_ADDRESS}?jetton=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs&amount=5000000`);
+    });
+    (0, vitest_1.it)('uses the cosmos sdk scheme', () => {
+        const address = 'cosmos1zqf0dq3nl3fhr8xk3pd2yq2sxwv0h2gd8qzptc';
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address, asset: ATOM, amountCryptoPrecision: '1' })).toBe(`cosmos:${address}?amount=1`);
+    });
+    (0, vitest_1.it)('falls back to the bare address on a chain with no scheme', () => {
+        const address = '0x04a1b2c3';
+        const starknet = asset('starknet:SN_MAIN/slip44:9004', 'starknet:SN_MAIN', 18);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address, asset: starknet, amountCryptoPrecision: '1' })).toBe(address);
+    });
+    (0, vitest_1.it)('omits the amount from schemes that need one, but keeps the evm chain id', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC })).toBe(BTC_ADDRESS);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: SOL_ADDRESS, asset: SOL })).toBe(SOL_ADDRESS);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: TON_ADDRESS, asset: TON_USDT })).toBe(TON_ADDRESS);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: BASE_ETH })).toBe(`ethereum:${EVM_ADDRESS}@8453`);
+    });
+    (0, vitest_1.it)('passes a zero amount through', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC, amountCryptoPrecision: '0' })).toBe(`bitcoin:${BTC_ADDRESS}?amount=0`);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: ETH, amountCryptoPrecision: '0' })).toBe(`ethereum:${EVM_ADDRESS}@1?value=0`);
+    });
+    (0, vitest_1.it)('throws on a Solana address that is not a public key, as Solana Pay did', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: 'not-a-pubkey', asset: SOL })).toBe('not-a-pubkey');
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: 'not-a-pubkey', asset: SOL, amountCryptoPrecision: '1' })).toThrow('Invalid Solana address');
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: `${SOL_ADDRESS}1`, asset: SOL, amountCryptoPrecision: '1' })).toThrow('Invalid Solana address');
+    });
+    (0, vitest_1.it)('writes a scientific-notation amount as a plain decimal', () => {
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC, amountCryptoPrecision: '1e-8' })).toBe(`bitcoin:${BTC_ADDRESS}?amount=0.00000001`);
+        (0, vitest_1.expect)((0, paymentUri_1.buildPaymentUri)({ address: SOL_ADDRESS, asset: SOL, amountCryptoPrecision: '1e-9' })).toBe(`solana:${SOL_ADDRESS}?amount=0.000000001`);
+    });
+    (0, vitest_1.it)('throws on an amount finer than the asset', () => {
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC, amountCryptoPrecision: '0.000000001' })).toThrow('exceeds 8 decimals');
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: USDC, amountCryptoPrecision: '0.0000001' })).toThrow('exceeds 6 decimals');
+    });
+    (0, vitest_1.it)('throws on an amount no wallet could pay', () => {
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: BTC_ADDRESS, asset: BTC, amountCryptoPrecision: '-1' })).toThrow('Invalid payment amount');
+        (0, vitest_1.expect)(() => (0, paymentUri_1.buildPaymentUri)({ address: EVM_ADDRESS, asset: ETH, amountCryptoPrecision: 'abc' })).toThrow('Invalid payment amount');
+    });
+});