@buildonspark/spark-sdk 0.1.40 → 0.1.41

package/dist/utils/index.cjs

@@ -42,6 +42,7 @@ __export(utils_exports, {
   bigIntToPrivateKey: () => bigIntToPrivateKey,
   calculateAvailableTokenAmount: () => calculateAvailableTokenAmount,
   checkIfSelectedOutputsAreAvailable: () => checkIfSelectedOutputsAreAvailable,
+  checkIfValidSequence: () => checkIfValidSequence,
   collectResponses: () => collectResponses,
   computeTaprootKeyNoScript: () => computeTaprootKeyNoScript,
   computerLagrangeCoefficients: () => computerLagrangeCoefficients,
@@ -76,6 +77,7 @@ __export(utils_exports, {
   getRandomSigningNonce: () => getRandomSigningNonce,
   getSigHashFromTx: () => getSigHashFromTx,
   getSigningCommitmentFromNonce: () => getSigningCommitmentFromNonce,
+  getSparkAddressFromTaproot: () => getSparkAddressFromTaproot,
   getTransactionSequence: () => getTransactionSequence,
   getTransferPackageSigningPayload: () => getTransferPackageSigningPayload,
   getTxFromRawTxBytes: () => getTxFromRawTxBytes,
@@ -665,6 +667,172 @@ var TreeNode = {
     return message;
   }
 };
+function createBaseSparkAddress() {
+  return { identityPublicKey: new Uint8Array(0), paymentIntentFields: void 0 };
+}
+var SparkAddress = {
+  encode(message, writer = new import_wire4.BinaryWriter()) {
+    if (message.identityPublicKey.length !== 0) {
+      writer.uint32(10).bytes(message.identityPublicKey);
+    }
+    if (message.paymentIntentFields !== void 0) {
+      PaymentIntentFields.encode(message.paymentIntentFields, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire4.BinaryReader ? input : new import_wire4.BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseSparkAddress();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.identityPublicKey = reader.bytes();
+          continue;
+        }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+          message.paymentIntentFields = PaymentIntentFields.decode(reader, reader.uint32());
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return {
+      identityPublicKey: isSet(object.identityPublicKey) ? bytesFromBase64(object.identityPublicKey) : new Uint8Array(0),
+      paymentIntentFields: isSet(object.paymentIntentFields) ? PaymentIntentFields.fromJSON(object.paymentIntentFields) : void 0
+    };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.identityPublicKey.length !== 0) {
+      obj.identityPublicKey = base64FromBytes(message.identityPublicKey);
+    }
+    if (message.paymentIntentFields !== void 0) {
+      obj.paymentIntentFields = PaymentIntentFields.toJSON(message.paymentIntentFields);
+    }
+    return obj;
+  },
+  create(base) {
+    return SparkAddress.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseSparkAddress();
+    message.identityPublicKey = object.identityPublicKey ?? new Uint8Array(0);
+    message.paymentIntentFields = object.paymentIntentFields !== void 0 && object.paymentIntentFields !== null ? PaymentIntentFields.fromPartial(object.paymentIntentFields) : void 0;
+    return message;
+  }
+};
+function createBasePaymentIntentFields() {
+  return { id: new Uint8Array(0), assetIdentifier: void 0, assetAmount: new Uint8Array(0), memo: void 0 };
+}
+var PaymentIntentFields = {
+  encode(message, writer = new import_wire4.BinaryWriter()) {
+    if (message.id.length !== 0) {
+      writer.uint32(10).bytes(message.id);
+    }
+    if (message.assetIdentifier !== void 0) {
+      writer.uint32(18).bytes(message.assetIdentifier);
+    }
+    if (message.assetAmount.length !== 0) {
+      writer.uint32(26).bytes(message.assetAmount);
+    }
+    if (message.memo !== void 0) {
+      writer.uint32(34).string(message.memo);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof import_wire4.BinaryReader ? input : new import_wire4.BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBasePaymentIntentFields();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.id = reader.bytes();
+          continue;
+        }
+        case 2: {
+          if (tag !== 18) {
+            break;
+          }
+          message.assetIdentifier = reader.bytes();
+          continue;
+        }
+        case 3: {
+          if (tag !== 26) {
+            break;
+          }
+          message.assetAmount = reader.bytes();
+          continue;
+        }
+        case 4: {
+          if (tag !== 34) {
+            break;
+          }
+          message.memo = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return {
+      id: isSet(object.id) ? bytesFromBase64(object.id) : new Uint8Array(0),
+      assetIdentifier: isSet(object.assetIdentifier) ? bytesFromBase64(object.assetIdentifier) : void 0,
+      assetAmount: isSet(object.assetAmount) ? bytesFromBase64(object.assetAmount) : new Uint8Array(0),
+      memo: isSet(object.memo) ? globalThis.String(object.memo) : void 0
+    };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.id.length !== 0) {
+      obj.id = base64FromBytes(message.id);
+    }
+    if (message.assetIdentifier !== void 0) {
+      obj.assetIdentifier = base64FromBytes(message.assetIdentifier);
+    }
+    if (message.assetAmount.length !== 0) {
+      obj.assetAmount = base64FromBytes(message.assetAmount);
+    }
+    if (message.memo !== void 0) {
+      obj.memo = message.memo;
+    }
+    return obj;
+  },
+  create(base) {
+    return PaymentIntentFields.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBasePaymentIntentFields();
+    message.id = object.id ?? new Uint8Array(0);
+    message.assetIdentifier = object.assetIdentifier ?? void 0;
+    message.assetAmount = object.assetAmount ?? new Uint8Array(0);
+    message.memo = object.memo ?? void 0;
+    return message;
+  }
+};
 function bytesFromBase64(b64) {
   if (globalThis.Buffer) {
     return Uint8Array.from(globalThis.Buffer.from(b64, "base64"));
@@ -1151,6 +1319,7 @@ var BASE_CONFIG = {
   threshold: 2,
   signingOperators: getLocalSigningOperators(),
   tokenSignatures: "SCHNORR",
+  tokenTransactionVersion: "V0",
   electrsUrl: getElectrsUrl("LOCAL"),
   expectedWithdrawBondSats: 1e4,
   expectedWithdrawRelativeBlockLocktime: 1e3,
@@ -1774,17 +1943,35 @@ function getTransactionSequence(currSequence) {
   const timelock = getCurrentTimelock(currSequence);
   return 1 << 30 | timelock;
 }
+function checkIfValidSequence(currSequence) {
+  const TIME_LOCK_ACTIVE = (currSequence || 0) & 2147483648;
+  if (TIME_LOCK_ACTIVE !== 0) {
+    throw new ValidationError("Timelock not active", {
+      field: "currSequence",
+      value: currSequence
+    });
+  }
+  const RELATIVE_TIME_LOCK_ACTIVE = (currSequence || 0) & 4194304;
+  if (RELATIVE_TIME_LOCK_ACTIVE !== 0) {
+    throw new ValidationError("Block based timelock not active", {
+      field: "currSequence",
+      value: currSequence
+    });
+  }
+}
 function getNextTransactionSequence(currSequence, forRefresh) {
+  checkIfValidSequence(currSequence);
   const currentTimelock = getCurrentTimelock(currSequence);
   const nextTimelock = currentTimelock - TIME_LOCK_INTERVAL;
+  checkIfValidSequence(nextTimelock);
   if (forRefresh && nextTimelock <= 100 && currentTimelock > 0) {
     return {
       nextSequence: 1 << 30 | nextTimelock,
       needRefresh: true
     };
   }
-  if (nextTimelock < 0) {
-    throw new ValidationError("timelock interval is less than or equal to 0", {
+  if (nextTimelock < 100) {
+    throw new ValidationError("timelock interval is less than 100", {
       field: "nextTimelock",
       value: nextTimelock
     });
@@ -2245,6 +2432,94 @@ function constructFeeBumpTx(txHex, utxos, feeRate, previousFeeBumpTx) {
     correctedParentTx: correctedTxHex !== txHex ? correctedTxHex : void 0
   };
 }
+
+// src/address/address.ts
+var import_secp256k16 = require("@noble/curves/secp256k1");
+var import_utils9 = require("@noble/hashes/utils");
+var import_base2 = require("@scure/base");
+var import_uuidv7 = require("uuidv7");
+var import_utils10 = require("@noble/curves/abstract/utils");
+var AddressNetwork = {
+  MAINNET: "sp",
+  TESTNET: "spt",
+  REGTEST: "sprt",
+  SIGNET: "sps",
+  LOCAL: "spl"
+};
+function encodeSparkAddress(payload) {
+  try {
+    isValidPublicKey(payload.identityPublicKey);
+    let paymentIntentFields;
+    if (payload.paymentIntentFields) {
+      paymentIntentFields = payload.paymentIntentFields;
+    }
+    const sparkAddressProto = SparkAddress.create({
+      identityPublicKey: (0, import_utils9.hexToBytes)(payload.identityPublicKey),
+      paymentIntentFields
+    });
+    const serializedPayload = SparkAddress.encode(sparkAddressProto).finish();
+    const words = import_base2.bech32m.toWords(serializedPayload);
+    return import_base2.bech32m.encode(
+      AddressNetwork[payload.network],
+      words,
+      500
+    );
+  } catch (error) {
+    throw new ValidationError(
+      "Failed to encode Spark address",
+      {
+        field: "publicKey",
+        value: payload.identityPublicKey
+      },
+      error
+    );
+  }
+}
+function isValidPublicKey(publicKey) {
+  try {
+    const point = import_secp256k16.secp256k1.ProjectivePoint.fromHex(publicKey);
+    point.assertValidity();
+  } catch (error) {
+    throw new ValidationError(
+      "Invalid public key",
+      {
+        field: "publicKey",
+        value: publicKey
+      },
+      error
+    );
+  }
+}
+
+// src/utils/xchain-address.ts
+var btc4 = __toESM(require("@scure/btc-signer"), 1);
+var networkByType = {
+  MAINNET: btc4.NETWORK,
+  TESTNET: btc4.TEST_NETWORK,
+  REGTEST: {
+    ...btc4.TEST_NETWORK,
+    bech32: "bcrt"
+  }
+};
+function getSparkAddressFromTaproot(taprootAddress) {
+  for (const networkType of ["MAINNET", "TESTNET", "REGTEST"]) {
+    try {
+      const result = btc4.Address(networkByType[networkType]).decode(taprootAddress);
+      if (result.type === "tr") {
+        const outputPublicKey = result.pubkey;
+        return encodeSparkAddress({
+          identityPublicKey: import_buffer.Buffer.concat([
+            import_buffer.Buffer.from([2]),
+            outputPublicKey
+          ]).toString("hex"),
+          network: networkType
+        });
+      }
+    } catch (_) {
+    }
+  }
+  throw new ValidationError("Invalid taproot address");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_FEE_SATS,
@@ -2259,6 +2534,7 @@ function constructFeeBumpTx(txHex, utxos, feeRate, previousFeeBumpTx) {
   bigIntToPrivateKey,
   calculateAvailableTokenAmount,
   checkIfSelectedOutputsAreAvailable,
+  checkIfValidSequence,
   collectResponses,
   computeTaprootKeyNoScript,
   computerLagrangeCoefficients,
@@ -2293,6 +2569,7 @@ function constructFeeBumpTx(txHex, utxos, feeRate, previousFeeBumpTx) {
   getRandomSigningNonce,
   getSigHashFromTx,
   getSigningCommitmentFromNonce,
+  getSparkAddressFromTaproot,
   getTransactionSequence,
   getTransferPackageSigningPayload,
   getTxFromRawTxBytes,

package/dist/utils/index.d.cts

@@ -1,11 +1,12 @@
 import * as btc from '@scure/btc-signer';
 import { Transaction } from '@scure/btc-signer';
 import { TransactionOutput, TransactionInput } from '@scure/btc-signer/psbt';
-import { N as Network } from '../network-B10hBoHp.cjs';
-export { L as LRC_WALLET_NETWORK, c as LRC_WALLET_NETWORK_TYPE, b as NetworkToProto, a as NetworkType, g as getNetwork, d as getNetworkFromAddress, e as getNetworkFromString } from '../network-B10hBoHp.cjs';
-import { i as SigningNonce, h as SigningCommitment } from '../signer-CYwn7h9U.cjs';
-export { V as VerifiableSecretShare, d as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, a as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, b as splitSecretWithProofs, v as validateShare } from '../signer-CYwn7h9U.cjs';
-import { j as OutputWithPreviousTransactionData, l as TransferPackage, g as SparkServiceClient } from '../spark-DXYE9gMM.cjs';
+import { N as Network } from '../network-BiwBmoOg.cjs';
+export { L as LRC_WALLET_NETWORK, c as LRC_WALLET_NETWORK_TYPE, b as NetworkToProto, a as NetworkType, g as getNetwork, d as getNetworkFromAddress, e as getNetworkFromString } from '../network-BiwBmoOg.cjs';
+import { i as SigningNonce, h as SigningCommitment } from '../signer-BhLS7SYR.cjs';
+export { V as VerifiableSecretShare, d as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, a as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, b as splitSecretWithProofs, v as validateShare } from '../signer-BhLS7SYR.cjs';
+import { j as OutputWithPreviousTransactionData, l as TransferPackage, g as SparkServiceClient } from '../spark-DjR1b3TC.cjs';
+import { SparkAddressFormat } from '../address/index.cjs';
 import '@buildonspark/lrc20-sdk';
 import 'bitcoinjs-lib';
 import '../BitcoinNetwork-TnABML0T.cjs';
@@ -75,6 +76,7 @@ declare function maybeApplyFee(amount: bigint): bigint;
 declare function createRefundTx(sequence: number, nodeOutPoint: TransactionInput, amountSats: bigint, receivingPubkey: Uint8Array, network: Network): Transaction;
 declare function getCurrentTimelock(currSequence?: number): number;
 declare function getTransactionSequence(currSequence?: number): number;
+declare function checkIfValidSequence(currSequence?: number): void;
 declare function getNextTransactionSequence(currSequence?: number, forRefresh?: boolean): {
     nextSequence: number;
     needRefresh: boolean;
@@ -130,4 +132,6 @@ declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRa
     correctedParentTx?: string;
 };
 
-export { type BroadcastConfig, type BroadcastResult, DEFAULT_FEE_SATS, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, type LeafInfo, Network, type TxChain, type Utxo, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, collectResponses, computeTaprootKeyNoScript, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, proofOfPossessionMessageHashForDepositAddress, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature };
+declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
+
+export { type BroadcastConfig, type BroadcastResult, DEFAULT_FEE_SATS, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, type LeafInfo, Network, type TxChain, type Utxo, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, proofOfPossessionMessageHashForDepositAddress, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature };

package/dist/utils/index.d.ts

@@ -1,11 +1,12 @@
 import * as btc from '@scure/btc-signer';
 import { Transaction } from '@scure/btc-signer';
 import { TransactionOutput, TransactionInput } from '@scure/btc-signer/psbt';
-import { N as Network } from '../network-CCgyIsGl.js';
-export { L as LRC_WALLET_NETWORK, c as LRC_WALLET_NETWORK_TYPE, b as NetworkToProto, a as NetworkType, g as getNetwork, d as getNetworkFromAddress, e as getNetworkFromString } from '../network-CCgyIsGl.js';
-import { i as SigningNonce, h as SigningCommitment } from '../signer-C5h1DpjF.js';
-export { V as VerifiableSecretShare, d as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, a as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, b as splitSecretWithProofs, v as validateShare } from '../signer-C5h1DpjF.js';
-import { j as OutputWithPreviousTransactionData, l as TransferPackage, g as SparkServiceClient } from '../spark-DXYE9gMM.js';
+import { N as Network } from '../network-BF2GYPye.js';
+export { L as LRC_WALLET_NETWORK, c as LRC_WALLET_NETWORK_TYPE, b as NetworkToProto, a as NetworkType, g as getNetwork, d as getNetworkFromAddress, e as getNetworkFromString } from '../network-BF2GYPye.js';
+import { i as SigningNonce, h as SigningCommitment } from '../signer-CylxIujU.js';
+export { V as VerifiableSecretShare, d as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, a as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, b as splitSecretWithProofs, v as validateShare } from '../signer-CylxIujU.js';
+import { j as OutputWithPreviousTransactionData, l as TransferPackage, g as SparkServiceClient } from '../spark-DjR1b3TC.js';
+import { SparkAddressFormat } from '../address/index.js';
 import '@buildonspark/lrc20-sdk';
 import 'bitcoinjs-lib';
 import '../BitcoinNetwork-TnABML0T.js';
@@ -75,6 +76,7 @@ declare function maybeApplyFee(amount: bigint): bigint;
 declare function createRefundTx(sequence: number, nodeOutPoint: TransactionInput, amountSats: bigint, receivingPubkey: Uint8Array, network: Network): Transaction;
 declare function getCurrentTimelock(currSequence?: number): number;
 declare function getTransactionSequence(currSequence?: number): number;
+declare function checkIfValidSequence(currSequence?: number): void;
 declare function getNextTransactionSequence(currSequence?: number, forRefresh?: boolean): {
     nextSequence: number;
     needRefresh: boolean;
@@ -130,4 +132,6 @@ declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRa
     correctedParentTx?: string;
 };
 
-export { type BroadcastConfig, type BroadcastResult, DEFAULT_FEE_SATS, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, type LeafInfo, Network, type TxChain, type Utxo, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, collectResponses, computeTaprootKeyNoScript, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, proofOfPossessionMessageHashForDepositAddress, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature };
+declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
+
+export { type BroadcastConfig, type BroadcastResult, DEFAULT_FEE_SATS, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, type LeafInfo, Network, type TxChain, type Utxo, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, proofOfPossessionMessageHashForDepositAddress, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature };

package/dist/utils/index.js

@@ -1,5 +1,6 @@
 import {
   DEFAULT_FEE_SATS,
+  checkIfValidSequence,
   computeTaprootKeyNoScript,
   constructFeeBumpTx,
   constructUnilateralExitFeeBumpPackages,
@@ -14,6 +15,7 @@ import {
   getP2TRScriptFromPublicKey,
   getP2WPKHAddressFromPublicKey,
   getSigHashFromTx,
+  getSparkAddressFromTaproot,
   getTransactionSequence,
   getTransferPackageSigningPayload,
   getTxFromRawTxBytes,
@@ -24,15 +26,9 @@ import {
   isTxBroadcast,
   maybeApplyFee,
   proofOfPossessionMessageHashForDepositAddress
-} from "../chunk-ED3ZAFDI.js";
-import "../chunk-A74XSEW3.js";
-import "../chunk-S7KD6DDL.js";
-import {
-  calculateAvailableTokenAmount,
-  checkIfSelectedOutputsAreAvailable,
-  collectResponses,
-  filterTokenBalanceForTokenPublicKey
-} from "../chunk-57XLH3ZR.js";
+} from "../chunk-YEZDPUFY.js";
+import "../chunk-MIVX3GHD.js";
+import "../chunk-6YVPOQ2A.js";
 import {
   LRC_WALLET_NETWORK,
   LRC_WALLET_NETWORK_TYPE,
@@ -42,7 +38,7 @@ import {
   getNetworkFromAddress,
   getNetworkFromString
 } from "../chunk-HK6LPV6Z.js";
-import "../chunk-ZUVYYR5T.js";
+import "../chunk-7EFSUADA.js";
 import {
   addPrivateKeys,
   addPublicKeys,
@@ -64,6 +60,14 @@ import {
   sumOfPrivateKeys,
   validateOutboundAdaptorSignature
 } from "../chunk-7VMYMQLF.js";
+import "../chunk-HMLOC6TE.js";
+import {
+  calculateAvailableTokenAmount,
+  checkIfSelectedOutputsAreAvailable,
+  collectResponses,
+  filterTokenBalanceForTokenPublicKey
+} from "../chunk-ATEHMLKP.js";
+import "../chunk-TM4TOEOX.js";
 import {
   bigIntToPrivateKey,
   computerLagrangeCoefficients,
@@ -77,10 +81,9 @@ import {
   splitSecretWithProofs,
   validateShare
 } from "../chunk-MGPRLH6Q.js";
-import "../chunk-HMLOC6TE.js";
 import "../chunk-VTUGIIWI.js";
 import "../chunk-TWF35O6M.js";
-import "../chunk-C5LTJBI7.js";
+import "../chunk-M6A4KFIG.js";
 import "../chunk-MVRQ5US7.js";
 export {
   DEFAULT_FEE_SATS,
@@ -95,6 +98,7 @@ export {
   bigIntToPrivateKey,
   calculateAvailableTokenAmount,
   checkIfSelectedOutputsAreAvailable,
+  checkIfValidSequence,
   collectResponses,
   computeTaprootKeyNoScript,
   computerLagrangeCoefficients,
@@ -129,6 +133,7 @@ export {
   getRandomSigningNonce,
   getSigHashFromTx,
   getSigningCommitmentFromNonce,
+  getSparkAddressFromTaproot,
   getTransactionSequence,
   getTransferPackageSigningPayload,
   getTxFromRawTxBytes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/spark-sdk",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "author": "",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -77,6 +77,10 @@
       "import": "./dist/proto/spark.js",
       "require": "./dist/proto/spark.cjs"
     },
+    "./proto/spark_token": {
+      "import": "./dist/proto/spark_token.js",
+      "require": "./dist/proto/spark_token.cjs"
+    },
     "./proto/lrc20": {
       "import": "./dist/proto/lrc20.js",
       "require": "./dist/proto/lrc20.cjs"
@@ -122,7 +126,7 @@
     "types:watch": "tsc-absolute --watch",
     "types": "tsc",
     "patch-wasm": "node ./wasm/patch-wasm.mjs",
-    "generate:proto": "PATH=\"$PATH:./node_modules/.bin\" protoc --ts_proto_out=./src/proto --ts_proto_opt=outputServices=nice-grpc,useExactTypes=false,outputServices=generic-definitions,oneof=unions,importSuffix=.js --proto_path=../../../../protos spark.proto mock.proto spark_authn.proto && yarn format:fix"
+    "generate:proto": "PATH=\"$PATH:./node_modules/.bin\" protoc --ts_proto_out=./src/proto --ts_proto_opt=outputServices=nice-grpc,useExactTypes=false,outputServices=generic-definitions,oneof=unions,importSuffix=.js --proto_path=../../../../protos spark.proto spark_token.proto mock.proto spark_authn.proto && yarn format:fix"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.4",

package/src/address/address.ts

@@ -1,10 +1,13 @@
 import { secp256k1 } from "@noble/curves/secp256k1";
 import { bytesToHex, hexToBytes } from "@noble/hashes/utils";
 import { bech32m } from "@scure/base";
-import { SparkAddress } from "../proto/spark.js";
+import { PaymentIntentFields, SparkAddress } from "../proto/spark.js";
 import { NetworkType } from "../utils/network.js";
 import { ValidationError } from "../errors/index.js";
 
+import { UUID, uuidv7 } from "uuidv7";
+import { bytesToNumberBE } from "@noble/curves/abstract/utils";
+
 const AddressNetwork: Record<NetworkType, string> = {
   MAINNET: "sp",
   TESTNET: "spt",
@@ -19,6 +22,18 @@ export type SparkAddressFormat =
 export interface SparkAddressData {
   identityPublicKey: string;
   network: NetworkType;
+  paymentIntentFields?: PaymentIntentFields;
+}
+
+export interface DecodedSparkAddressData {
+  identityPublicKey: string;
+  network: NetworkType;
+  paymentIntentFields?: {
+    id: string;
+    assetIdentifier?: string;
+    assetAmount: bigint;
+    memo?: string;
+  };
 }
 
 export function encodeSparkAddress(
@@ -27,8 +42,14 @@ export function encodeSparkAddress(
   try {
     isValidPublicKey(payload.identityPublicKey);
 
+    let paymentIntentFields: PaymentIntentFields | undefined;
+    if (payload.paymentIntentFields) {
+      paymentIntentFields = payload.paymentIntentFields;
+    }
+
     const sparkAddressProto = SparkAddress.create({
       identityPublicKey: hexToBytes(payload.identityPublicKey),
+      paymentIntentFields,
     });
 
     const serializedPayload = SparkAddress.encode(sparkAddressProto).finish();
@@ -37,7 +58,7 @@ export function encodeSparkAddress(
     return bech32m.encode(
       AddressNetwork[payload.network],
       words,
-      200,
+      500,
     ) as SparkAddressFormat;
   } catch (error) {
     throw new ValidationError(
@@ -54,9 +75,10 @@ export function encodeSparkAddress(
 export function decodeSparkAddress(
   address: string,
   network: NetworkType,
-): string {
+): DecodedSparkAddressData {
   try {
-    const decoded = bech32m.decode(address as SparkAddressFormat, 200);
+    const decoded = bech32m.decode(address as SparkAddressFormat, 500);
+
     if (decoded.prefix !== AddressNetwork[network]) {
       throw new ValidationError("Invalid Spark address prefix", {
         field: "address",
@@ -71,7 +93,20 @@ export function decodeSparkAddress(
 
     isValidPublicKey(publicKey);
 
-    return publicKey;
+    const paymentIntentFields = payload.paymentIntentFields;
+
+    return {
+      identityPublicKey: publicKey,
+      network,
+      paymentIntentFields: paymentIntentFields && {
+        id: UUID.ofInner(paymentIntentFields.id).toString(),
+        assetIdentifier: paymentIntentFields.assetIdentifier
+          ? bytesToHex(paymentIntentFields.assetIdentifier)
+          : undefined,
+        assetAmount: bytesToNumberBE(paymentIntentFields.assetAmount),
+        memo: paymentIntentFields.memo,
+      },
+    };
   } catch (error) {
     if (error instanceof ValidationError) {
       throw error;
@@ -118,7 +153,7 @@ export function isValidSparkAddress(address: string) {
   }
 }
 
-function isValidPublicKey(publicKey: string) {
+export function isValidPublicKey(publicKey: string) {
   try {
     const point = secp256k1.ProjectivePoint.fromHex(publicKey);
     point.assertValidity();

package/src/graphql/client.ts

@@ -40,6 +40,7 @@ import type {
   RequestLeavesSwapInput,
   RequestLightningReceiveInput,
   RequestLightningSendInput,
+  Transfer,
 } from "./objects/index.js";
 import { LeavesSwapFeeEstimateOutputFromJson } from "./objects/LeavesSwapFeeEstimateOutput.js";
 import LeavesSwapRequest, {
@@ -56,6 +57,7 @@ import StaticDepositQuoteInput from "./objects/StaticDepositQuoteInput.js";
 import StaticDepositQuoteOutput, {
   StaticDepositQuoteOutputFromJson,
 } from "./objects/StaticDepositQuoteOutput.js";
+import { TransferFromJson } from "./objects/Transfer.js";
 import VerifyChallengeOutput, {
   VerifyChallengeOutputFromJson,
 } from "./objects/VerifyChallengeOutput.js";
@@ -63,6 +65,7 @@ import { CoopExitFeeEstimate } from "./queries/CoopExitFeeEstimate.js";
 import { GetClaimDepositQuote } from "./queries/GetClaimDepositQuote.js";
 import { LeavesSwapFeeEstimate } from "./queries/LeavesSwapFeeEstimate.js";
 import { LightningSendFeeEstimate } from "./queries/LightningSendFeeEstimate.js";
+import { GetTransfer } from "./queries/Transfer.js";
 import { UserRequest } from "./queries/UserRequest.js";
 
 export interface SspClientOptions {
@@ -456,6 +459,18 @@ export default class SspClient {
     });
   }
 
+  async getTransfer(id: string): Promise<Transfer | null> {
+    return await this.executeRawQuery({
+      queryPayload: GetTransfer,
+      variables: {
+        transfer_spark_id: id,
+      },
+      constructObject: (response: { transfer: any }) => {
+        return TransferFromJson(response.transfer);
+      },
+    });
+  }
+
   async getChallenge(): Promise<GetChallengeOutput | null> {
     return await this.executeRawQuery(
       {