@keyban/sdk-base/dist/stellar-PRHQHVS4.mjs.map

Keyban Javascript SDK provides core functionalities for the MPC wallet solution, supporting web and Node.js apps with TypeScript, custom storage, and Ethereum blockchain integration.

{"version":3,"sources":["../src/stellar/account.ts","../src/stellar/signer.ts","../src/stellar/client.ts"],"names":["TX_VALIDITY_DURATION","STELLAR_DECIMALS","BigNumber","StellarAccount","KeybanAccount","#signer","#rpcProvider","rpcClient","rpcProvider","signer","publicKey","message","hash","Buffer","to","value","account","networkDetails","paymentTx","TransactionBuilder","BASE_FEE","Operation","Asset","signature","#submitTransaction","_to","_params","tx","response","finalResponse","rpc","rawTx","networkPassphrase","setupTx","Transaction","StellarSigner","#rpcClient","#clientShare","#publicKey","clientShare","StrKey","data","hexSignature","hint","xdr","keyHint","byte","i","a","ed25519","id","StellarClient","KeybanClientBase","config","metadataConfig","provider","stellarPubKey"],"mappings":"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","file":"stellar-PRHQHVS4.mjs","sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\nimport {\n  Asset,\n  BASE_FEE,\n  FeeBumpTransaction,\n  Operation,\n  rpc,\n  Transaction,\n  TransactionBuilder,\n} from \"@stellar/stellar-sdk\";\nimport { BigNumber } from \"bignumber.js\";\nimport { Buffer } from \"buffer\";\n\nimport {\n  Address,\n  EstimateERC20TransferParams,\n  EstimateNftTransferParams,\n  FeesEstimation,\n  Hash,\n  Hex,\n  KeybanAccount,\n  TransferERC20Params,\n  TransferNftParams,\n} from \"~/index\";\nimport { RpcClient } from \"~/rpc\";\nimport { StellarSigner } from \"~/stellar/signer\";\n\nconst TX_VALIDITY_DURATION = 25; // Slightly below the default polling timeout of 30 seconds\nconst STELLAR_DECIMALS = 7;\nBigNumber.config({\n  DECIMAL_PLACES: STELLAR_DECIMALS,\n});\n\nexport class StellarAccount extends KeybanAccount {\n  address: string;\n  publicKey: string;\n  #signer: StellarSigner;\n  #rpcProvider: rpc.Server;\n\n  constructor(\n    rpcClient: RpcClient,\n    rpcProvider: rpc.Server,\n    signer: StellarSigner,\n    publicKey: string,\n  ) {\n    super(rpcClient);\n\n    this.#rpcProvider = rpcProvider;\n    this.#signer = signer;\n\n    this.address = publicKey; // stellar addresses aren't hexa https://stellar.github.io/js-stellar-sdk/Address.html#Address\n    this.publicKey = publicKey; // account.accountId == publicKey == address\n  }\n\n  async signMessage(message: string): Promise<Hex | string[]> {\n    const hash = await crypto.subtle.digest(\n      \"SHA-256\",\n      new TextEncoder().encode(message),\n    );\n    const signedMessage = await this.#signer.sign(Buffer.from(hash));\n    return signedMessage.toString(\"base64\");\n  }\n\n  async transfer(to: Address, value: bigint): Promise<string> {\n    const [account, networkDetails] = await Promise.all([\n      this.#rpcProvider.getAccount(this.address),\n      this.#rpcProvider.getNetwork(),\n    ]);\n    const paymentTx = new TransactionBuilder(account, {\n      fee: BASE_FEE,\n      networkPassphrase: networkDetails.passphrase,\n    })\n      .addOperation(\n        Operation.payment({\n          destination: to,\n          asset: Asset.native(),\n          amount: BigNumber(value)\n            .dividedBy(10 ** STELLAR_DECIMALS)\n            .toString(),\n        }),\n      )\n      .setTimeout(TX_VALIDITY_DURATION)\n      .build();\n\n    // sign the transaction\n    const signature = await this.#signer.signDecorated(paymentTx.hash());\n    paymentTx.addDecoratedSignature(signature);\n\n    // submit the transaction to the network\n    return this.#submitTransaction(paymentTx);\n  }\n\n  estimateTransfer(_to: Address): Promise<FeesEstimation> {\n    throw new Error(\"estimateTransfer not implemented.\");\n  }\n\n  transferERC20(_params: TransferERC20Params): Promise<Hash> {\n    throw new Error(\"transferERC20 not implemented.\");\n  }\n\n  estimateERC20Transfer(\n    _params: EstimateERC20TransferParams,\n  ): Promise<FeesEstimation> {\n    throw new Error(\"estimateERC20Transfer not implemented.\");\n  }\n\n  transferNft(_params: TransferNftParams): Promise<Hash> {\n    throw new Error(\"transferNft not implemented.\");\n  }\n\n  estimateNftTransfer(\n    _params: EstimateNftTransferParams,\n  ): Promise<FeesEstimation> {\n    throw new Error(\"estimateNftTransfer not implemented.\");\n  }\n\n  async #submitTransaction(\n    tx: Transaction | FeeBumpTransaction,\n  ): Promise<string> {\n    return this.#rpcProvider\n      .sendTransaction(tx)\n      .then(async (response) => {\n        if (response.status !== \"PENDING\") {\n          throw response; // TODO handle this better\n        }\n        return this.#rpcProvider.pollTransaction(response.hash);\n      })\n      .then((finalResponse) => {\n        switch (finalResponse.status) {\n          case rpc.Api.GetTransactionStatus.FAILED:\n          case rpc.Api.GetTransactionStatus.NOT_FOUND:\n            throw finalResponse; // TODO handle this better\n          case rpc.Api.GetTransactionStatus.SUCCESS:\n            return finalResponse.txHash;\n        }\n      });\n  }\n\n  async loyaltySetup(): Promise<void> {\n    try {\n      const account = await this.#rpcProvider.getAccount(this.publicKey);\n      if (account) return;\n    } catch {\n      console.log(\"Stellar Account not yet setup for Loyalty, Doing it now...\");\n    }\n    // Init the account setup\n    const rawTx = await this.rpcClient.call(\"loyalty\", \"initAccountSetup\");\n    // Decode the raw transaction\n    const { passphrase: networkPassphrase } =\n      await this.#rpcProvider.getNetwork();\n    const setupTx = new Transaction(rawTx, networkPassphrase);\n    // sign the transaction\n    const signature = await this.#signer.signDecorated(setupTx.hash());\n    setupTx.addDecoratedSignature(signature);\n    // serialize and submit the transaction to the network\n    await this.rpcClient.call(\"loyalty\", \"submitAccountSetup\", setupTx.toXDR());\n  }\n}\n","import { ed25519 } from \"@noble/curves/ed25519\";\nimport { KeypairType, StrKey, xdr } from \"@stellar/stellar-sdk\";\nimport { Buffer } from \"buffer\";\n\nimport { Hex } from \"~/index\";\nimport { RpcClient } from \"~/rpc\";\n\n/**\n * StellarSigner\n * This class provides functionality for signing transactions and messages on the Stellar blockchain.\n * It closely resembles the Keypair interface from the stellar-sdk, but its signing methods are asynchronous.\n */\nexport class StellarSigner {\n  type: KeypairType = \"ed25519\";\n\n  #rpcClient: RpcClient;\n  #clientShare: string;\n  #publicKey: Hex;\n\n  constructor(rpcClient: RpcClient, clientShare: string, publicKey: Hex) {\n    this.#rpcClient = rpcClient;\n    this.#clientShare = clientShare;\n    this.#publicKey = publicKey;\n  }\n\n  publicKey(): string {\n    return StrKey.encodeEd25519PublicKey(this.rawPublicKey());\n  }\n\n  rawPublicKey(): Buffer {\n    const publicKey = this.#publicKey.replace(/^0x/, \"\");\n    return Buffer.from(publicKey, \"hex\");\n  }\n\n  async sign(data: Buffer): Promise<Buffer> {\n    const hexSignature = await this.#rpcClient.call(\n      \"eddsa\",\n      \"sign\",\n      this.#clientShare,\n      data.toString(\"hex\"),\n    );\n    return Buffer.from(hexSignature, \"hex\");\n  }\n\n  async signDecorated(data: Buffer): Promise<xdr.DecoratedSignature> {\n    const signature = await this.sign(data);\n    const hint = this.signatureHint();\n\n    return new xdr.DecoratedSignature({ hint, signature });\n  }\n\n  async signPayloadDecorated(data: Buffer): Promise<xdr.DecoratedSignature> {\n    const signature = await this.sign(data);\n    const keyHint = this.signatureHint();\n\n    let hint = Buffer.from(data.slice(-4));\n    if (hint.length < 4) {\n      // append zeroes as needed\n      hint = Buffer.concat([hint, Buffer.alloc(4 - data.length, 0)]);\n    }\n\n    return new xdr.DecoratedSignature({\n      hint: hint.map((byte, i) => byte ^ keyHint[i]) as Buffer,\n      signature,\n    });\n  }\n\n  signatureHint(): Buffer {\n    const a = this.xdrAccountId().toXDR();\n    return a.slice(a.length - 4);\n  }\n\n  verify(data: Buffer, signature: Buffer): boolean {\n    try {\n      return ed25519.verify(signature, data, this.rawPublicKey());\n    } catch {\n      return false;\n    }\n  }\n\n  xdrAccountId(): xdr.AccountId {\n    return xdr.PublicKey.publicKeyTypeEd25519(this.rawPublicKey());\n  }\n\n  xdrPublicKey(): xdr.PublicKey {\n    return xdr.PublicKey.publicKeyTypeEd25519(this.rawPublicKey());\n  }\n\n  xdrMuxedAccount(id: string): xdr.MuxedAccount {\n    if (typeof id !== \"undefined\") {\n      if (typeof id !== \"string\") {\n        throw new TypeError(`expected string for ID, got ${typeof id}`);\n      }\n\n      return xdr.MuxedAccount.keyTypeMuxedEd25519(\n        new xdr.MuxedAccountMed25519({\n          id: xdr.Uint64.fromString(id),\n          ed25519: this.rawPublicKey(),\n        }),\n      );\n    }\n\n    return xdr.MuxedAccount.keyTypeEd25519(this.rawPublicKey());\n  }\n}\n","import { rpc, StrKey } from \"@stellar/stellar-sdk\";\nimport { Buffer } from \"buffer\";\n\nimport { KeybanClientBase, KeybanClientConfig, MetadataConfig } from \"~/client\";\nimport { StellarAccount } from \"~/stellar/account\";\nimport { StellarSigner } from \"~/stellar/signer\";\n\nexport class StellarClient extends KeybanClientBase {\n  #rpcProvider: Promise<rpc.Server>;\n\n  constructor(\n    config: KeybanClientConfig,\n    metadataConfig?: Promise<MetadataConfig>,\n  ) {\n    super(config, metadataConfig);\n\n    this.#rpcProvider = this.metadataConfig.then(\n      (config) => new rpc.Server(config.network.rpcUrl),\n    );\n  }\n\n  async initialize(): Promise<StellarAccount> {\n    let clientShare = await this.clientShareProvider.get(\"eddsa\");\n    if (!clientShare) {\n      clientShare = await this.rpcClient.call(\"eddsa\", \"dkg\");\n      await this.clientShareProvider.set(\"eddsa\", clientShare);\n    }\n\n    const [provider, publicKey] = await Promise.all([\n      this.#rpcProvider,\n      this.rpcClient.call(\"eddsa\", \"publicKey\", clientShare),\n    ]);\n\n    const signer = new StellarSigner(this.rpcClient, clientShare, publicKey);\n\n    const stellarPubKey = StrKey.encodeEd25519PublicKey(\n      Buffer.from(publicKey, \"hex\"),\n    );\n\n    return new StellarAccount(this.rpcClient, provider, signer, stellarPubKey);\n  }\n}\n"]}