@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/cjs/base/auth.js

@@ -0,0 +1,244 @@
+'use strict';
+
+var buffer = require('buffer');
+var curr_generated = require('./generated/curr_generated.js');
+var keypair = require('./keypair.js');
+var strkey = require('./strkey.js');
+var hashing = require('./hashing.js');
+var address = require('./address.js');
+var scval = require('./scval.js');
+
+function toBuffer(value) {
+  if (value instanceof ArrayBuffer) {
+    return buffer.Buffer.from(new Uint8Array(value));
+  }
+  return buffer.Buffer.from(value);
+}
+async function authorizeEntry(entry, signer, validUntilLedgerSeq, networkPassphrase, forAddress) {
+  if (entry.credentials().switch().value === curr_generated.default.SorobanCredentialsType.sorobanCredentialsSourceAccount().value) {
+    return entry;
+  }
+  const clone = curr_generated.default.SorobanAuthorizationEntry.fromXDR(entry.toXDR());
+  const credentials = clone.credentials();
+  const addrAuth = getAddressCredentials(credentials);
+  if (addrAuth === null) {
+    throw new Error(`unsupported credential type ${credentials.switch().name}`);
+  }
+  addrAuth.signatureExpirationLedger(validUntilLedgerSeq);
+  const preimage = buildAuthorizationEntryPreimage(
+    clone,
+    validUntilLedgerSeq,
+    networkPassphrase
+  );
+  const payload = hashing.hash(preimage.toXDR());
+  let signature;
+  let publicKey;
+  if (typeof signer === "function") {
+    const sigResult = await signer(preimage);
+    if (sigResult !== null && typeof sigResult === "object" && "signature" in sigResult) {
+      signature = toBuffer(sigResult.signature);
+      publicKey = sigResult.publicKey;
+    } else {
+      signature = toBuffer(sigResult);
+      publicKey = address.Address.fromScAddress(addrAuth.address()).toString();
+    }
+  } else {
+    signature = toBuffer(signer.sign(payload));
+    publicKey = signer.publicKey();
+  }
+  if (!keypair.Keypair.fromPublicKey(publicKey).verify(payload, signature)) {
+    throw new Error(`signature doesn't match payload`);
+  }
+  const sigScVal = scval.nativeToScVal(
+    {
+      public_key: strkey.StrKey.decodeEd25519PublicKey(publicKey),
+      signature
+    },
+    {
+      type: {
+        public_key: ["symbol", null],
+        signature: ["symbol", null]
+      }
+    }
+  );
+  const signatureScVal = curr_generated.default.ScVal.scvVec([sigScVal]);
+  const targets = forAddress === void 0 ? [addrAuth] : collectSignatureNodes(credentials).filter(
+    (node) => address.Address.fromScAddress(node.address()).toString() === forAddress
+  );
+  if (targets.length === 0) {
+    throw new Error(
+      `the authorization entry has no credential node for address ${forAddress}`
+    );
+  }
+  targets.forEach((node) => node.signature(signatureScVal));
+  return clone;
+}
+function authorizeInvocation(params) {
+  const {
+    signer,
+    validUntilLedgerSeq,
+    invocation,
+    networkPassphrase,
+    publicKey = "",
+    authV2 = false
+  } = params;
+  const kp = keypair.Keypair.random().rawPublicKey();
+  const nonce = new curr_generated.default.Int64(bytesToInt64(kp));
+  const pk = publicKey || (signer instanceof keypair.Keypair ? signer.publicKey() : null);
+  if (!pk) {
+    throw new Error(`authorizeInvocation requires publicKey parameter`);
+  }
+  const addressCredentials = new curr_generated.default.SorobanAddressCredentials({
+    address: new address.Address(pk).toScAddress(),
+    nonce,
+    signatureExpirationLedger: 0,
+    // replaced
+    signature: curr_generated.default.ScVal.scvVec([])
+    // replaced
+  });
+  const entry = new curr_generated.default.SorobanAuthorizationEntry({
+    rootInvocation: invocation,
+    credentials: authV2 ? curr_generated.default.SorobanCredentials.sorobanCredentialsAddressV2(addressCredentials) : curr_generated.default.SorobanCredentials.sorobanCredentialsAddress(addressCredentials)
+  });
+  return authorizeEntry(entry, signer, validUntilLedgerSeq, networkPassphrase);
+}
+function buildAuthorizationEntryPreimage(entry, validUntilLedgerSeq, networkPassphrase) {
+  const credentials = entry.credentials();
+  const addrAuth = getAddressCredentials(credentials);
+  if (addrAuth === null) {
+    throw new Error(
+      `cannot build a signature payload for credential type ${credentials.switch().name}`
+    );
+  }
+  const networkId = hashing.hash(buffer.Buffer.from(networkPassphrase));
+  switch (credentials.switch().value) {
+    // legacy address credentials are not address-bound
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddress().value:
+      return curr_generated.default.HashIdPreimage.envelopeTypeSorobanAuthorization(
+        new curr_generated.default.HashIdPreimageSorobanAuthorization({
+          networkId,
+          nonce: addrAuth.nonce(),
+          invocation: entry.rootInvocation(),
+          signatureExpirationLedger: validUntilLedgerSeq
+        })
+      );
+    // ADDRESS_V2 and ADDRESS_WITH_DELEGATES bind the address into the signed
+    // payload via the WithAddress preimage (CAP-71)
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressV2().value:
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates().value:
+      return curr_generated.default.HashIdPreimage.envelopeTypeSorobanAuthorizationWithAddress(
+        new curr_generated.default.HashIdPreimageSorobanAuthorizationWithAddress({
+          networkId,
+          nonce: addrAuth.nonce(),
+          invocation: entry.rootInvocation(),
+          address: addrAuth.address(),
+          signatureExpirationLedger: validUntilLedgerSeq
+        })
+      );
+    default:
+      throw new Error(
+        `unsupported credential type ${credentials.switch().name}`
+      );
+  }
+}
+function buildWithDelegatesEntry(params) {
+  const { entry, validUntilLedgerSeq, delegates, signature } = params;
+  const credentials = entry.credentials();
+  const addrAuth = getAddressCredentials(credentials);
+  if (addrAuth === null || credentials.switch().value === curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates().value) {
+    throw new Error(
+      `buildWithDelegatesEntry expects ADDRESS or ADDRESS_V2 credentials, got ${credentials.switch().name}`
+    );
+  }
+  return new curr_generated.default.SorobanAuthorizationEntry({
+    rootInvocation: entry.rootInvocation(),
+    credentials: curr_generated.default.SorobanCredentials.sorobanCredentialsAddressWithDelegates(
+      new curr_generated.default.SorobanAddressCredentialsWithDelegates({
+        addressCredentials: new curr_generated.default.SorobanAddressCredentials({
+          address: addrAuth.address(),
+          nonce: addrAuth.nonce(),
+          signatureExpirationLedger: validUntilLedgerSeq,
+          signature: signature ?? curr_generated.default.ScVal.scvVoid()
+        }),
+        delegates: buildDelegateNodes(delegates)
+      })
+    )
+  });
+}
+function buildDelegateNodes(delegates) {
+  const nodes = delegates.map(
+    (delegate) => new curr_generated.default.SorobanDelegateSignature({
+      address: new address.Address(delegate.address).toScAddress(),
+      signature: delegate.signature ?? curr_generated.default.ScVal.scvVoid(),
+      nestedDelegates: buildDelegateNodes(delegate.nestedDelegates ?? [])
+    })
+  );
+  nodes.sort(
+    (a, b) => buffer.Buffer.compare(a.address().toXDR(), b.address().toXDR())
+  );
+  for (let i = 1; i < nodes.length; i++) {
+    if (buffer.Buffer.compare(
+      nodes[i - 1].address().toXDR(),
+      nodes[i].address().toXDR()
+    ) === 0) {
+      throw new Error(
+        `duplicate delegate address ${address.Address.fromScAddress(
+          nodes[i].address()
+        ).toString()}`
+      );
+    }
+  }
+  return nodes;
+}
+function getAddressCredentials(credentials) {
+  switch (credentials.switch().value) {
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddress().value:
+      return credentials.address();
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressV2().value:
+      return credentials.addressV2();
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates().value:
+      return credentials.addressWithDelegates().addressCredentials();
+    default:
+      return null;
+  }
+}
+function collectSignatureNodes(credentials) {
+  switch (credentials.switch().value) {
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddress().value:
+      return [credentials.address()];
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressV2().value:
+      return [credentials.addressV2()];
+    case curr_generated.default.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates().value: {
+      const withDelegates = credentials.addressWithDelegates();
+      const nodes = [withDelegates.addressCredentials()];
+      const walk = (delegates) => {
+        delegates.forEach((delegate) => {
+          nodes.push(delegate);
+          walk(delegate.nestedDelegates());
+        });
+      };
+      walk(withDelegates.delegates());
+      return nodes;
+    }
+    default:
+      return [];
+  }
+}
+function bytesToInt64(bytes) {
+  const buf = bytes.subarray(0, 8);
+  if (buf.length < 8) {
+    throw new Error(
+      `need at least 8 bytes to convert to Int64, got ${bytes.length}`
+    );
+  }
+  const view = new DataView(buf.buffer, buf.byteOffset, 8);
+  const value = view.getBigInt64(0, false);
+  return value;
+}
+
+exports.authorizeEntry = authorizeEntry;
+exports.authorizeInvocation = authorizeInvocation;
+exports.buildAuthorizationEntryPreimage = buildAuthorizationEntryPreimage;
+exports.buildWithDelegatesEntry = buildWithDelegatesEntry;
+exports.getAddressCredentials = getAddressCredentials;
+//# sourceMappingURL=auth.js.map

package/lib/axios/cjs/base/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sources":["../../../../src/base/auth.ts"],"sourcesContent":["import xdr from \"./xdr.js\";\n\nimport { Keypair } from \"./keypair.js\";\nimport { StrKey } from \"./strkey.js\";\n\nimport type { Networks } from \"./network.js\";\nimport { hash } from \"./hashing.js\";\n\nimport { Address } from \"./address.js\";\nimport { nativeToScVal } from \"./scval.js\";\n\ntype BufferLike = ArrayBuffer | Buffer | Uint8Array;\n\nfunction toBuffer(value: BufferLike): Buffer {\n  if (value instanceof ArrayBuffer) {\n    return Buffer.from(new Uint8Array(value));\n  }\n  return Buffer.from(value);\n}\n\n/**\n * A callback for signing an XDR structure representing all of the details\n * necessary to authorize an invocation tree.\n *\n * @param preimage - the entire authorization envelope whose hash you should\n *    sign, so that you can inspect the entire structure if necessary (rather\n *    than blindly signing a hash)\n *\n * @returns the signature of the raw payload (which is the sha256 hash of the\n *    preimage bytes, so `hash(preimage.toXDR())`) either naked, implying it is\n *    signed by the key corresponding to the public key in the entry you pass to\n *    {@link authorizeEntry} (decipherable from its\n *    `credentials().address().address()`), or alongside an explicit `publicKey`.\n */\nexport type SigningCallback = (\n  preimage: xdr.HashIdPreimage,\n) => Promise<BufferLike | { signature: BufferLike; publicKey: string }>;\n\n/**\n * Actually authorizes an existing authorization entry using the given\n * credentials and expiration details, returning a signed copy.\n *\n * This \"fills out\" the authorization entry with a signature, indicating to the\n * {@link Operation.invokeHostFunction} its attached to that:\n *   - a particular identity (i.e. signing {@link Keypair} or other signer)\n *   - approving the execution of an invocation tree (i.e. a simulation-acquired\n *     {@link xdr.SorobanAuthorizedInvocation} or otherwise built)\n *   - on a particular network (uniquely identified by its passphrase, see\n *     {@link Networks})\n *   - until a particular ledger sequence is reached.\n *\n * This one lets you pass either a {@link Keypair} (or, more accurately,\n * anything with a `sign(Buffer): Buffer` method) or a callback function (see\n * {@link SigningCallback}) to handle signing the envelope hash.\n *\n * @param entry - an unsigned authorization entry\n * @param signer - either a {@link Keypair} instance or a function which takes a\n *    {@link xdr.HashIdPreimageSorobanAuthorization} input payload and returns\n *    EITHER\n *\n *      (a) an object containing a `signature` of the hash of the raw payload\n *          bytes as a Buffer-like and a `publicKey` string representing who just\n *          created this signature, or\n *      (b) just the naked signature of the hash of the raw payload bytes (where\n *          the signing key is implied to be the address in the `entry`).\n *\n *    The latter option (b) is JUST for backwards compatibility and will be\n *    removed in the future.\n * @param validUntilLedgerSeq - the (exclusive) future ledger sequence number\n *    until which this authorization entry should be valid (if\n *    `currentLedgerSeq==validUntil`, this is expired)\n * @param networkPassphrase - the network passphrase is incorporated into the\n *    signature (see {@link Networks} for options)\n *\n * If using the `SigningCallback` variation, the signer is assumed to be\n * the entry's credential address unless you use the variant that returns\n * the object.\n *\n * @param forAddress - which credential node the signature should be written\n *    to. Only relevant for `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES`, where\n *    a single entry can be signed by the top-level account and/or any of its\n *    (possibly nested) delegates. Per CAP-71-01 every one of these signers\n *    signs the *same* payload (bound to the top-level address), so the\n *    signature produced here is written to whichever node(s) carry\n *    `forAddress`. When omitted, the signature is written to the top-level\n *    credentials, which preserves the behavior for `SOROBAN_CREDENTIALS_ADDRESS`\n *    / `SOROBAN_CREDENTIALS_ADDRESS_V2` and for accounts whose signing key\n *    differs from the credential address (e.g. multisig).\n *\n * @see authorizeInvocation\n * @example\n * ```ts\n * import {\n *   SorobanRpc,\n *   Transaction,\n *   Networks,\n *   authorizeEntry\n * } from '@stellar/stellar-sdk';\n *\n * // Assume signPayloadCallback is a well-formed signing callback.\n * //\n * // It might, for example, pop up a modal from a browser extension, send the\n * // transaction to a third-party service for signing, or just do simple\n * // signing via Keypair like it does here:\n * function signPayloadCallback(payload) {\n *    return signer.sign(hash(payload.toXDR()));\n * }\n *\n * function multiPartyAuth(\n *    server: SorobanRpc.Server,\n *    // assume this involves multi-party auth\n *    tx: Transaction,\n * ) {\n *    return server\n *      .simulateTransaction(tx)\n *      .then((simResult) => {\n *          tx.operations[0].auth.map(entry =>\n *            authorizeEntry(\n *              entry,\n *              signPayloadCallback,\n *              currentLedger + 1000,\n *              Networks.TESTNET)\n *          );\n *\n *          return server.prepareTransaction(tx, simResult);\n *      })\n *      .then((preppedTx) => {\n *        preppedTx.sign(source);\n *        return server.sendTransaction(preppedTx);\n *      });\n * }\n * ```\n */\nexport async function authorizeEntry(\n  entry: xdr.SorobanAuthorizationEntry,\n  signer: Keypair | SigningCallback,\n  validUntilLedgerSeq: number,\n  networkPassphrase: string,\n  forAddress?: string,\n): Promise<xdr.SorobanAuthorizationEntry> {\n  // no-op if it's source account auth\n  if (\n    entry.credentials().switch().value ===\n    xdr.SorobanCredentialsType.sorobanCredentialsSourceAccount().value\n  ) {\n    return entry;\n  }\n\n  const clone = xdr.SorobanAuthorizationEntry.fromXDR(entry.toXDR());\n  const credentials = clone.credentials();\n  const addrAuth = getAddressCredentials(credentials);\n  if (addrAuth === null) {\n    // We should have already returned if the credentials were source account credentials,\n    // so if we can't get address credentials out of this, it's an unsupported credential type.\n    throw new Error(`unsupported credential type ${credentials.switch().name}`);\n  }\n\n  // Set the expiration before building the preimage, so the hash that gets\n  // signed commits to the same expiration ledger stored in the credentials.\n  // Otherwise the network reconstructs the preimage from the (updated)\n  // credentials and the signature no longer matches.\n  addrAuth.signatureExpirationLedger(validUntilLedgerSeq);\n\n  const preimage = buildAuthorizationEntryPreimage(\n    clone,\n    validUntilLedgerSeq,\n    networkPassphrase,\n  );\n\n  const payload = hash(preimage.toXDR());\n\n  let signature: Buffer;\n  let publicKey: string;\n  if (typeof signer === \"function\") {\n    const sigResult = await signer(preimage);\n    if (\n      sigResult !== null &&\n      typeof sigResult === \"object\" &&\n      \"signature\" in sigResult\n    ) {\n      signature = toBuffer(sigResult.signature);\n      publicKey = sigResult.publicKey;\n    } else {\n      // if using the deprecated form, assume it's for the entry\n      signature = toBuffer(sigResult);\n      publicKey = Address.fromScAddress(addrAuth.address()).toString();\n    }\n  } else {\n    signature = toBuffer(signer.sign(payload));\n    publicKey = signer.publicKey();\n  }\n\n  if (!Keypair.fromPublicKey(publicKey).verify(payload, signature)) {\n    throw new Error(`signature doesn't match payload`);\n  }\n\n  // This structure is defined here:\n  // https://soroban.stellar.org/docs/fundamentals-and-concepts/invoking-contracts-with-transactions#stellar-account-signatures\n  //\n  // Encoding a contract structure as an ScVal means the map keys are supposed\n  // to be symbols, hence the forced typing here.\n  const sigScVal = nativeToScVal(\n    {\n      public_key: StrKey.decodeEd25519PublicKey(publicKey),\n      signature,\n    },\n    {\n      type: {\n        public_key: [\"symbol\", null],\n        signature: [\"symbol\", null],\n      },\n    },\n  );\n\n  const signatureScVal = xdr.ScVal.scvVec([sigScVal]);\n\n  // CAP-71-01: the signature payload is shared across the top-level address\n  // and every (possibly nested) delegate, so this signer's signature is\n  // written to whichever credential node(s) carry `forAddress`. When no\n  // `forAddress` is given we fall back to the top-level credentials, which\n  // preserves the behavior for ADDRESS / ADDRESS_V2 and for accounts whose\n  // signing key differs from the credential address (e.g. multisig).\n  const targets: SignableCredential[] =\n    forAddress === undefined\n      ? [addrAuth]\n      : collectSignatureNodes(credentials).filter(\n          (node) =>\n            Address.fromScAddress(node.address()).toString() === forAddress,\n        );\n\n  if (targets.length === 0) {\n    throw new Error(\n      `the authorization entry has no credential node for address ${forAddress}`,\n    );\n  }\n\n  targets.forEach((node) => node.signature(signatureScVal));\n  return clone;\n}\n\nexport interface AuthorizeInvocationParams {\n  signer: Keypair | SigningCallback;\n  validUntilLedgerSeq: number;\n  invocation: xdr.SorobanAuthorizedInvocation;\n  networkPassphrase: string;\n  publicKey?: string;\n  /**\n   * Build `SOROBAN_CREDENTIALS_ADDRESS_V2` (CAP-71) credentials instead of the\n   * legacy `SOROBAN_CREDENTIALS_ADDRESS`. V2 credentials bind the address into\n   * the signed payload but are only valid on networks that have activated\n   * CAP-71, so leave this off until the activation vote passes for your target\n   * network. The default flips to `true` once V2 becomes mandatory.\n   * @defaultValue false\n   */\n  authV2?: boolean;\n}\n/**\n * This builds an entry from scratch, allowing you to express authorization as a\n * function of:\n *   - a particular identity (i.e. signing {@link Keypair} or other signer)\n *   - approving the execution of an invocation tree (i.e. a simulation-acquired\n *     {@link xdr.SorobanAuthorizedInvocation} or otherwise built)\n *   - on a particular network (uniquely identified by its passphrase, see\n *     {@link Networks})\n *   - until a particular ledger sequence is reached.\n *\n * This is in contrast to {@link authorizeEntry}, which signs an existing entry.\n *\n * @param params - the parameters for building and signing the authorization\n *   - `signer`: either a {@link Keypair} instance (or anything with a\n *    `.sign(buf): Buffer-like` method) or a function which takes a payload (a\n *    {@link xdr.HashIdPreimageSorobanAuthorization} instance) input and returns\n *    the signature of the hash of the raw payload bytes (where the signing key\n *    should correspond to the address in the `entry`)\n *   - `validUntilLedgerSeq`: the (exclusive) future ledger sequence\n *    number until which this authorization entry should be valid (if\n *    `currentLedgerSeq==validUntilLedgerSeq`, this is expired)\n *   - `invocation`: the invocation tree that we're authorizing\n *    (likely, this comes from transaction simulation)\n *   - `networkPassphrase`: the network passphrase is incorporated into\n *    the signature (see {@link Networks} for options)\n *   - `publicKey`: the public identity of the signer (when providing a\n *    {@link Keypair} to `signer`, this can be omitted, as it just uses\n *    {@link Keypair.publicKey})\n *   - `authV2`: build `SOROBAN_CREDENTIALS_ADDRESS_V2` (CAP-71) credentials\n *    rather than the legacy `SOROBAN_CREDENTIALS_ADDRESS`. Defaults to `false`;\n *    only enable it for networks that have activated CAP-71.\n *\n * @see authorizeEntry\n */\nexport function authorizeInvocation(\n  params: AuthorizeInvocationParams,\n): Promise<xdr.SorobanAuthorizationEntry> {\n  const {\n    signer,\n    validUntilLedgerSeq,\n    invocation,\n    networkPassphrase,\n    publicKey = \"\",\n    authV2 = false,\n  } = params;\n  // We use keypairs as a source of randomness for the nonce to avoid mucking\n  // with any crypto dependencies. Note that this just has to be random and\n  // unique, not cryptographically secure, so it's fine.\n  const kp = Keypair.random().rawPublicKey();\n  const nonce = new xdr.Int64(bytesToInt64(kp));\n\n  const pk =\n    publicKey || (signer instanceof Keypair ? signer.publicKey() : null);\n  if (!pk) {\n    throw new Error(`authorizeInvocation requires publicKey parameter`);\n  }\n\n  // V1 and V2 carry the identical SorobanAddressCredentials payload; only the\n  // credential union arm differs. authorizeEntry picks the matching signature\n  // preimage (legacy vs. address-bound) off whichever arm we build here.\n  const addressCredentials = new xdr.SorobanAddressCredentials({\n    address: new Address(pk).toScAddress(),\n    nonce,\n    signatureExpirationLedger: 0, // replaced\n    signature: xdr.ScVal.scvVec([]), // replaced\n  });\n\n  const entry = new xdr.SorobanAuthorizationEntry({\n    rootInvocation: invocation,\n    credentials: authV2\n      ? xdr.SorobanCredentials.sorobanCredentialsAddressV2(addressCredentials)\n      : xdr.SorobanCredentials.sorobanCredentialsAddress(addressCredentials),\n  });\n\n  return authorizeEntry(entry, signer, validUntilLedgerSeq, networkPassphrase);\n}\n\n/**\n * Builds the {@link xdr.HashIdPreimage} whose hash a signer must sign to\n * authorize `entry`. This is the low-level signature payload used by\n * {@link authorizeEntry}, exposed for callers that drive signing themselves —\n * most notably for `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES`, where the\n * client (not simulation) decides which delegates sign and how.\n *\n * For `SOROBAN_CREDENTIALS_ADDRESS` this is the legacy, non-address-bound\n * `ENVELOPE_TYPE_SOROBAN_AUTHORIZATION` preimage. For `SOROBAN_CREDENTIALS_ADDRESS_V2`\n * and `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES` it is the address-bound\n * `ENVELOPE_TYPE_SOROBAN_AUTHORIZATION_WITH_ADDRESS` preimage (CAP-71). For the\n * delegates variant this single payload — bound to the *top-level* address — is\n * what the top-level account and every (nested) delegate each sign.\n *\n * To get the raw bytes to sign, hash the XDR: `hash(preimage.toXDR())`.\n *\n * @param entry - the authorization entry to build the payload for\n * @param validUntilLedgerSeq - the expiration ledger committed into the payload\n *    (must match the `signatureExpirationLedger` on the credentials you submit)\n * @param networkPassphrase - the network passphrase mixed into the payload\n * @throws `Error` if `entry` carries source-account or otherwise non-address\n *    credentials\n */\nexport function buildAuthorizationEntryPreimage(\n  entry: xdr.SorobanAuthorizationEntry,\n  validUntilLedgerSeq: number,\n  networkPassphrase: string,\n): xdr.HashIdPreimage {\n  const credentials = entry.credentials();\n  const addrAuth = getAddressCredentials(credentials);\n  if (addrAuth === null) {\n    throw new Error(\n      `cannot build a signature payload for credential type ${credentials.switch().name}`,\n    );\n  }\n\n  const networkId = hash(Buffer.from(networkPassphrase));\n\n  switch (credentials.switch().value) {\n    // legacy address credentials are not address-bound\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddress().value:\n      return xdr.HashIdPreimage.envelopeTypeSorobanAuthorization(\n        new xdr.HashIdPreimageSorobanAuthorization({\n          networkId,\n          nonce: addrAuth.nonce(),\n          invocation: entry.rootInvocation(),\n          signatureExpirationLedger: validUntilLedgerSeq,\n        }),\n      );\n\n    // ADDRESS_V2 and ADDRESS_WITH_DELEGATES bind the address into the signed\n    // payload via the WithAddress preimage (CAP-71)\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressV2().value:\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates()\n      .value:\n      return xdr.HashIdPreimage.envelopeTypeSorobanAuthorizationWithAddress(\n        new xdr.HashIdPreimageSorobanAuthorizationWithAddress({\n          networkId,\n          nonce: addrAuth.nonce(),\n          invocation: entry.rootInvocation(),\n          address: addrAuth.address(),\n          signatureExpirationLedger: validUntilLedgerSeq,\n        }),\n      );\n\n    default:\n      throw new Error(\n        `unsupported credential type ${credentials.switch().name}`,\n      );\n  }\n}\n\n/**\n * A delegate signer to attach to a\n * `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES` entry via\n * {@link buildWithDelegatesEntry}.\n */\nexport interface DelegateSignature {\n  /** the delegate's address (`G…` account or `C…` contract). */\n  address: string;\n  /**\n   * the delegate's signature value. Defaults to a `scvVoid` placeholder, which\n   * you can fill afterwards with {@link authorizeEntry} (passing this address\n   * as `forAddress`) or by editing the entry directly.\n   */\n  signature?: xdr.ScVal;\n  /** signers this delegate in turn delegates to (recursive). */\n  nestedDelegates?: DelegateSignature[];\n}\n\n/** Parameters for {@link buildWithDelegatesEntry}. */\nexport interface BuildWithDelegatesParams {\n  /**\n   * an existing `SOROBAN_CREDENTIALS_ADDRESS` or\n   * `SOROBAN_CREDENTIALS_ADDRESS_V2` entry — typically one returned by\n   * simulation — whose address credentials should be wrapped.\n   */\n  entry: xdr.SorobanAuthorizationEntry;\n  /** the expiration ledger sequence stored on the top-level credentials. */\n  validUntilLedgerSeq: number;\n  /** the delegate signers to attach. */\n  delegates: DelegateSignature[];\n  /**\n   * the top-level account's signature. Defaults to `scvVoid`, which is valid\n   * for accounts that authorize purely via delegated signers (CAP-71-01).\n   */\n  signature?: xdr.ScVal;\n}\n\n/**\n * Builds a `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES` authorization entry by\n * wrapping the address credentials of an existing `ADDRESS`/`ADDRESS_V2` entry\n * (e.g. one returned by simulation) together with a caller-provided set of\n * delegate signers.\n *\n * Simulation never emits the delegates variant on its own — which accounts use\n * delegated authentication is account-specific policy known only to the client\n * (much like a multisig policy). This helper just assembles the wrapper XDR;\n * you supply the delegate tree (addresses and, optionally, signatures). To\n * produce the signatures, build the shared payload with\n * {@link buildAuthorizationEntryPreimage} on the returned entry and sign it,\n * or fill each node afterwards with {@link authorizeEntry} (passing the\n * signer's address as `forAddress`).\n *\n * Each delegates array (the top-level set and every `nestedDelegates`) is\n * sorted by address in ascending order, and duplicate addresses within an array\n * are rejected, as the protocol requires (CAP-71-01) — otherwise the host\n * rejects the entry.\n *\n * @param params - see {@link BuildWithDelegatesParams}\n * @throws `Error` if `entry` is not an `ADDRESS`/`ADDRESS_V2` entry, or if any\n *    delegates array contains a duplicate address.\n */\nexport function buildWithDelegatesEntry(\n  params: BuildWithDelegatesParams,\n): xdr.SorobanAuthorizationEntry {\n  const { entry, validUntilLedgerSeq, delegates, signature } = params;\n  const credentials = entry.credentials();\n  const addrAuth = getAddressCredentials(credentials);\n  if (\n    addrAuth === null ||\n    credentials.switch().value ===\n      xdr.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates().value\n  ) {\n    throw new Error(\n      `buildWithDelegatesEntry expects ADDRESS or ADDRESS_V2 credentials, got ${\n        credentials.switch().name\n      }`,\n    );\n  }\n\n  return new xdr.SorobanAuthorizationEntry({\n    rootInvocation: entry.rootInvocation(),\n    credentials: xdr.SorobanCredentials.sorobanCredentialsAddressWithDelegates(\n      new xdr.SorobanAddressCredentialsWithDelegates({\n        addressCredentials: new xdr.SorobanAddressCredentials({\n          address: addrAuth.address(),\n          nonce: addrAuth.nonce(),\n          signatureExpirationLedger: validUntilLedgerSeq,\n          signature: signature ?? xdr.ScVal.scvVoid(),\n        }),\n        delegates: buildDelegateNodes(delegates),\n      }),\n    ),\n  });\n}\n\n/**\n * Recursively converts {@link DelegateSignature} descriptors into\n * {@link xdr.SorobanDelegateSignature} nodes, sorting each level by address and\n * rejecting duplicates (CAP-71-01).\n */\nfunction buildDelegateNodes(\n  delegates: DelegateSignature[],\n): xdr.SorobanDelegateSignature[] {\n  const nodes = delegates.map(\n    (delegate) =>\n      new xdr.SorobanDelegateSignature({\n        address: new Address(delegate.address).toScAddress(),\n        signature: delegate.signature ?? xdr.ScVal.scvVoid(),\n        nestedDelegates: buildDelegateNodes(delegate.nestedDelegates ?? []),\n      }),\n  );\n\n  nodes.sort((a, b) =>\n    Buffer.compare(a.address().toXDR(), b.address().toXDR()),\n  );\n\n  for (let i = 1; i < nodes.length; i++) {\n    if (\n      Buffer.compare(\n        nodes[i - 1].address().toXDR(),\n        nodes[i].address().toXDR(),\n      ) === 0\n    ) {\n      throw new Error(\n        `duplicate delegate address ${Address.fromScAddress(\n          nodes[i].address(),\n        ).toString()}`,\n      );\n    }\n  }\n\n  return nodes;\n}\n\n/**\n * Internal helper — intentionally NOT re-exported from `base/index.js`, so it\n * is not part of the public SDK API. Shared with the contract package, which\n * imports it directly from this module. If a public need arises, add it to the\n * explicit auth re-exports in `base/index.ts`.\n *\n * Extracts the {@link xdr.SorobanAddressCredentials} from any address-based\n * Soroban credential, regardless of which credential type variant is used.\n *\n * This unifies access across `SOROBAN_CREDENTIALS_ADDRESS`,\n * `SOROBAN_CREDENTIALS_ADDRESS_V2` (which carries identical fields but binds\n * the address into the signature payload), and\n * `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES` (which wraps the same address\n * credentials alongside a set of delegate signatures).\n *\n * @param credentials - the credentials to inspect\n * @returns the inner address credentials, or `null` for source-account\n *    credentials (which carry no address payload)\n */\nexport function getAddressCredentials(\n  credentials: xdr.SorobanCredentials,\n): xdr.SorobanAddressCredentials | null {\n  switch (credentials.switch().value) {\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddress().value:\n      return credentials.address();\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressV2().value:\n      return credentials.addressV2();\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates()\n      .value:\n      return credentials.addressWithDelegates().addressCredentials();\n    default:\n      return null;\n  }\n}\n\n/**\n * The common shape of every node in an authorization entry that can carry a\n * signature: the top-level {@link xdr.SorobanAddressCredentials} and, for the\n * delegates variant, each {@link xdr.SorobanDelegateSignature}. Both expose an\n * `address()` and a `signature()` accessor.\n */\ninterface SignableCredential {\n  address(value?: xdr.ScAddress): xdr.ScAddress;\n  signature(value?: xdr.ScVal): xdr.ScVal;\n}\n\n/**\n * Internal helper. Returns every node in an address-based credential that can\n * carry a signature, in a stable order: the top-level address credentials\n * first, then (only for `SOROBAN_CREDENTIALS_ADDRESS_WITH_DELEGATES`) the\n * delegates and their nested delegates, depth-first. Returns an empty array\n * for source-account credentials, which carry no signature.\n *\n * Per CAP-71-01 all of these nodes commit to the same payload (the one bound to\n * the top-level address), so the caller can fill any of them with a signature\n * produced from that shared payload.\n */\nfunction collectSignatureNodes(\n  credentials: xdr.SorobanCredentials,\n): SignableCredential[] {\n  switch (credentials.switch().value) {\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddress().value:\n      return [credentials.address()];\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressV2().value:\n      return [credentials.addressV2()];\n    case xdr.SorobanCredentialsType.sorobanCredentialsAddressWithDelegates()\n      .value: {\n      const withDelegates = credentials.addressWithDelegates();\n      const nodes: SignableCredential[] = [withDelegates.addressCredentials()];\n      const walk = (delegates: xdr.SorobanDelegateSignature[]) => {\n        delegates.forEach((delegate) => {\n          nodes.push(delegate);\n          walk(delegate.nestedDelegates());\n        });\n      };\n      walk(withDelegates.delegates());\n      return nodes;\n    }\n    default:\n      return [];\n  }\n}\n\nfunction bytesToInt64(bytes: Uint8Array): bigint {\n  const buf = bytes.subarray(0, 8);\n  if (buf.length < 8) {\n    throw new Error(\n      `need at least 8 bytes to convert to Int64, got ${bytes.length}`,\n    );\n  }\n  const view = new DataView(buf.buffer, buf.byteOffset, 8);\n  const value = view.getBigInt64(0, false);\n\n  return value;\n}\n"],"names":["Buffer","xdr","hash","Address","Keypair","nativeToScVal","StrKey"],"mappings":"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"}

package/lib/axios/cjs/base/claimant.js

@@ -0,0 +1,147 @@
+'use strict';
+
+var curr_generated = require('./generated/curr_generated.js');
+var keypair = require('./keypair.js');
+var strkey = require('./strkey.js');
+
+class Claimant {
+  _destination;
+  _predicate;
+  /**
+   * @param destination - The destination account ID.
+   * @param predicate - The claim predicate.
+   */
+  constructor(destination, predicate) {
+    if (!strkey.StrKey.isValidEd25519PublicKey(destination)) {
+      throw new Error("Destination is invalid");
+    }
+    this._destination = destination;
+    if (!predicate) {
+      this._predicate = curr_generated.default.ClaimPredicate.claimPredicateUnconditional();
+    } else if (predicate instanceof curr_generated.default.ClaimPredicate) {
+      this._predicate = predicate;
+    } else {
+      throw new Error("Predicate should be an xdr.ClaimPredicate");
+    }
+  }
+  /**
+   * Returns an unconditional claim predicate
+   */
+  static predicateUnconditional() {
+    return curr_generated.default.ClaimPredicate.claimPredicateUnconditional();
+  }
+  /**
+   * Returns an `and` claim predicate
+   * @param left - an xdr.ClaimPredicate
+   * @param right - an xdr.ClaimPredicate
+   */
+  static predicateAnd(left, right) {
+    if (!(left instanceof curr_generated.default.ClaimPredicate)) {
+      throw new Error("left Predicate should be an xdr.ClaimPredicate");
+    }
+    if (!(right instanceof curr_generated.default.ClaimPredicate)) {
+      throw new Error("right Predicate should be an xdr.ClaimPredicate");
+    }
+    return curr_generated.default.ClaimPredicate.claimPredicateAnd([left, right]);
+  }
+  /**
+   * Returns an `or` claim predicate
+   * @param left - an xdr.ClaimPredicate
+   * @param right - an xdr.ClaimPredicate
+   */
+  static predicateOr(left, right) {
+    if (!(left instanceof curr_generated.default.ClaimPredicate)) {
+      throw new Error("left Predicate should be an xdr.ClaimPredicate");
+    }
+    if (!(right instanceof curr_generated.default.ClaimPredicate)) {
+      throw new Error("right Predicate should be an xdr.ClaimPredicate");
+    }
+    return curr_generated.default.ClaimPredicate.claimPredicateOr([left, right]);
+  }
+  /**
+   * Returns a `not` claim predicate
+   * @param predicate - an xdr.ClaimPredicate
+   */
+  static predicateNot(predicate) {
+    if (!(predicate instanceof curr_generated.default.ClaimPredicate)) {
+      throw new Error("Predicate should be an xdr.ClaimPredicate");
+    }
+    return curr_generated.default.ClaimPredicate.claimPredicateNot(predicate);
+  }
+  /**
+   * Returns a `BeforeAbsoluteTime` claim predicate
+   *
+   * This predicate will be fulfilled if the closing time of the ledger that
+   * includes the CreateClaimableBalance operation is less than this (absolute)
+   * Unix timestamp (expressed in seconds).
+   *
+   * @param absBefore - Unix epoch (in seconds) as a string
+   */
+  static predicateBeforeAbsoluteTime(absBefore) {
+    return curr_generated.default.ClaimPredicate.claimPredicateBeforeAbsoluteTime(
+      curr_generated.default.Int64.fromString(absBefore)
+    );
+  }
+  /**
+   * Returns a `BeforeRelativeTime` claim predicate
+   *
+   * This predicate will be fulfilled if the closing time of the ledger that
+   * includes the CreateClaimableBalance operation plus this relative time delta
+   * (in seconds) is less than the current time.
+   *
+   * @param seconds - seconds since closeTime of the ledger in which the ClaimableBalanceEntry was created (as string)
+   */
+  static predicateBeforeRelativeTime(seconds) {
+    return curr_generated.default.ClaimPredicate.claimPredicateBeforeRelativeTime(
+      curr_generated.default.Int64.fromString(seconds)
+    );
+  }
+  /**
+   * Returns a claimant object from its XDR object representation.
+   * @param claimantXdr - The claimant xdr object.
+   */
+  static fromXDR(claimantXdr) {
+    let value;
+    switch (claimantXdr.switch()) {
+      case curr_generated.default.ClaimantType.claimantTypeV0():
+        value = claimantXdr.v0();
+        return new this(
+          strkey.StrKey.encodeEd25519PublicKey(value.destination().ed25519()),
+          value.predicate()
+        );
+      default:
+        throw new Error(`Invalid claimant type: ${claimantXdr.switch().name}`);
+    }
+  }
+  /**
+   * Returns the xdr object for this claimant.
+   */
+  toXDRObject() {
+    const claimant = new curr_generated.default.ClaimantV0({
+      destination: keypair.Keypair.fromPublicKey(this._destination).xdrAccountId(),
+      predicate: this._predicate
+    });
+    return curr_generated.default.Claimant.claimantTypeV0(claimant);
+  }
+  /**
+   * The destination account ID.
+   */
+  get destination() {
+    return this._destination;
+  }
+  set destination(_value) {
+    throw new Error("Claimant is immutable");
+  }
+  /**
+   * The claim predicate.
+   */
+  get predicate() {
+    return this._predicate;
+  }
+  set predicate(_value) {
+    throw new Error("Claimant is immutable");
+  }
+}
+
+exports.Claimant = Claimant;
+//# sourceMappingURL=claimant.js.map

package/lib/axios/cjs/base/claimant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimant.js","sources":["../../../../src/base/claimant.ts"],"sourcesContent":["import xdr from \"./xdr.js\";\nimport { Keypair } from \"./keypair.js\";\nimport { StrKey } from \"./strkey.js\";\n\n/**\n * Claimant class represents an xdr.Claimant\n *\n * The claim predicate is optional, it defaults to unconditional if none is specified.\n */\nexport class Claimant {\n  private _destination: string;\n  private _predicate: xdr.ClaimPredicate;\n\n  /**\n   * @param destination - The destination account ID.\n   * @param predicate - The claim predicate.\n   */\n  constructor(destination: string, predicate?: xdr.ClaimPredicate) {\n    if (!StrKey.isValidEd25519PublicKey(destination)) {\n      throw new Error(\"Destination is invalid\");\n    }\n    this._destination = destination;\n\n    if (!predicate) {\n      this._predicate = xdr.ClaimPredicate.claimPredicateUnconditional();\n    } else if (predicate instanceof xdr.ClaimPredicate) {\n      this._predicate = predicate;\n    } else {\n      throw new Error(\"Predicate should be an xdr.ClaimPredicate\");\n    }\n  }\n\n  /**\n   * Returns an unconditional claim predicate\n   */\n  static predicateUnconditional(): xdr.ClaimPredicate {\n    return xdr.ClaimPredicate.claimPredicateUnconditional();\n  }\n\n  /**\n   * Returns an `and` claim predicate\n   * @param left - an xdr.ClaimPredicate\n   * @param right - an xdr.ClaimPredicate\n   */\n  static predicateAnd(\n    left: xdr.ClaimPredicate,\n    right: xdr.ClaimPredicate,\n  ): xdr.ClaimPredicate {\n    if (!(left instanceof xdr.ClaimPredicate)) {\n      throw new Error(\"left Predicate should be an xdr.ClaimPredicate\");\n    }\n    if (!(right instanceof xdr.ClaimPredicate)) {\n      throw new Error(\"right Predicate should be an xdr.ClaimPredicate\");\n    }\n\n    return xdr.ClaimPredicate.claimPredicateAnd([left, right]);\n  }\n\n  /**\n   * Returns an `or` claim predicate\n   * @param left - an xdr.ClaimPredicate\n   * @param right - an xdr.ClaimPredicate\n   */\n  static predicateOr(\n    left: xdr.ClaimPredicate,\n    right: xdr.ClaimPredicate,\n  ): xdr.ClaimPredicate {\n    if (!(left instanceof xdr.ClaimPredicate)) {\n      throw new Error(\"left Predicate should be an xdr.ClaimPredicate\");\n    }\n    if (!(right instanceof xdr.ClaimPredicate)) {\n      throw new Error(\"right Predicate should be an xdr.ClaimPredicate\");\n    }\n\n    return xdr.ClaimPredicate.claimPredicateOr([left, right]);\n  }\n\n  /**\n   * Returns a `not` claim predicate\n   * @param predicate - an xdr.ClaimPredicate\n   */\n  static predicateNot(predicate: xdr.ClaimPredicate): xdr.ClaimPredicate {\n    if (!(predicate instanceof xdr.ClaimPredicate)) {\n      throw new Error(\"Predicate should be an xdr.ClaimPredicate\");\n    }\n\n    return xdr.ClaimPredicate.claimPredicateNot(predicate);\n  }\n\n  /**\n   * Returns a `BeforeAbsoluteTime` claim predicate\n   *\n   * This predicate will be fulfilled if the closing time of the ledger that\n   * includes the CreateClaimableBalance operation is less than this (absolute)\n   * Unix timestamp (expressed in seconds).\n   *\n   * @param absBefore - Unix epoch (in seconds) as a string\n   */\n  static predicateBeforeAbsoluteTime(absBefore: string): xdr.ClaimPredicate {\n    return xdr.ClaimPredicate.claimPredicateBeforeAbsoluteTime(\n      xdr.Int64.fromString(absBefore),\n    );\n  }\n\n  /**\n   * Returns a `BeforeRelativeTime` claim predicate\n   *\n   * This predicate will be fulfilled if the closing time of the ledger that\n   * includes the CreateClaimableBalance operation plus this relative time delta\n   * (in seconds) is less than the current time.\n   *\n   * @param seconds - seconds since closeTime of the ledger in which the ClaimableBalanceEntry was created (as string)\n   */\n  static predicateBeforeRelativeTime(seconds: string): xdr.ClaimPredicate {\n    return xdr.ClaimPredicate.claimPredicateBeforeRelativeTime(\n      xdr.Int64.fromString(seconds),\n    );\n  }\n\n  /**\n   * Returns a claimant object from its XDR object representation.\n   * @param claimantXdr - The claimant xdr object.\n   */\n  static fromXDR(claimantXdr: xdr.Claimant): Claimant {\n    let value;\n    switch (claimantXdr.switch()) {\n      case xdr.ClaimantType.claimantTypeV0():\n        value = claimantXdr.v0();\n        return new this(\n          StrKey.encodeEd25519PublicKey(value.destination().ed25519()),\n          value.predicate(),\n        );\n      default:\n        throw new Error(`Invalid claimant type: ${claimantXdr.switch().name}`);\n    }\n  }\n\n  /**\n   * Returns the xdr object for this claimant.\n   */\n  toXDRObject(): xdr.Claimant {\n    const claimant = new xdr.ClaimantV0({\n      destination: Keypair.fromPublicKey(this._destination).xdrAccountId(),\n      predicate: this._predicate,\n    });\n\n    return xdr.Claimant.claimantTypeV0(claimant);\n  }\n\n  /**\n   * The destination account ID.\n   */\n  get destination() {\n    return this._destination;\n  }\n\n  set destination(_value: string) {\n    throw new Error(\"Claimant is immutable\");\n  }\n\n  /**\n   * The claim predicate.\n   */\n  get predicate() {\n    return this._predicate;\n  }\n\n  set predicate(_value: xdr.ClaimPredicate) {\n    throw new Error(\"Claimant is immutable\");\n  }\n}\n"],"names":["StrKey","xdr","Keypair"],"mappings":"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"}

package/lib/axios/cjs/base/contract.js

@@ -0,0 +1,72 @@
+'use strict';
+
+var address = require('./address.js');
+var operation = require('./operation.js');
+var curr_generated = require('./generated/curr_generated.js');
+var strkey = require('./strkey.js');
+
+class Contract {
+  _id;
+  /**
+   * @param contractId - ID of the contract (ex.
+   *     `CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE`).
+   */
+  constructor(contractId) {
+    try {
+      this._id = strkey.StrKey.decodeContract(contractId);
+    } catch {
+      throw new Error(`Invalid contract ID: ${contractId}`);
+    }
+  }
+  /**
+   * Returns Stellar contract ID as a strkey, ex.
+   * `CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE`.
+   */
+  contractId() {
+    return strkey.StrKey.encodeContract(this._id);
+  }
+  /** Returns the ID as a strkey (C...). */
+  toString() {
+    return this.contractId();
+  }
+  /** Returns the wrapped address of this contract. */
+  address() {
+    return address.Address.contract(this._id);
+  }
+  /**
+   * Returns an operation that will invoke this contract call.
+   *
+   * @param method - name of the method to call
+   * @param params - arguments to pass to the method, as an array of xdr.ScVal
+   *
+   * @see Operation.invokeHostFunction
+   * @see Operation.invokeContractFunction
+   * @see Operation.createCustomContract
+   * @see Operation.createStellarAssetContract
+   * @see Operation.uploadContractWasm
+   */
+  call(method, ...params) {
+    return operation.Operation.invokeContractFunction({
+      contract: this.address().toString(),
+      function: method,
+      args: params
+    });
+  }
+  /**
+   * Returns the read-only footprint entries necessary for any invocations to
+   * this contract, for convenience when manually adding it to your
+   * transaction's overall footprint or doing bump/restore operations.
+   */
+  getFootprint() {
+    return curr_generated.default.LedgerKey.contractData(
+      new curr_generated.default.LedgerKeyContractData({
+        contract: this.address().toScAddress(),
+        key: curr_generated.default.ScVal.scvLedgerKeyContractInstance(),
+        durability: curr_generated.default.ContractDataDurability.persistent()
+      })
+    );
+  }
+}
+
+exports.Contract = Contract;
+//# sourceMappingURL=contract.js.map

package/lib/axios/cjs/base/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sources":["../../../../src/base/contract.ts"],"sourcesContent":["import { Address } from \"./address.js\";\nimport { Operation } from \"./operation.js\";\nimport xdr from \"./xdr.js\";\nimport { StrKey } from \"./strkey.js\";\n\n/**\n * Create a new Contract object.\n *\n * `Contract` represents a single contract in the Stellar network, embodying the\n * interface of the contract. See\n * [Contracts](https://soroban.stellar.org/docs/learn/interacting-with-contracts)\n * for more information about how contracts work in Stellar.\n */\nexport class Contract {\n  private _id: Buffer;\n\n  /**\n   * @param contractId - ID of the contract (ex.\n   *     `CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE`).\n   */\n  constructor(contractId: string) {\n    try {\n      // First, try it as a strkey\n      this._id = StrKey.decodeContract(contractId);\n    } catch {\n      throw new Error(`Invalid contract ID: ${contractId}`);\n    }\n  }\n\n  /**\n   * Returns Stellar contract ID as a strkey, ex.\n   * `CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE`.\n   */\n  contractId(): string {\n    return StrKey.encodeContract(this._id);\n  }\n\n  /** Returns the ID as a strkey (C...). */\n  toString(): string {\n    return this.contractId();\n  }\n\n  /** Returns the wrapped address of this contract. */\n  address(): Address {\n    return Address.contract(this._id);\n  }\n\n  /**\n   * Returns an operation that will invoke this contract call.\n   *\n   * @param method - name of the method to call\n   * @param params - arguments to pass to the method, as an array of xdr.ScVal\n   *\n   * @see Operation.invokeHostFunction\n   * @see Operation.invokeContractFunction\n   * @see Operation.createCustomContract\n   * @see Operation.createStellarAssetContract\n   * @see Operation.uploadContractWasm\n   */\n  call(\n    method: string,\n    ...params: xdr.ScVal[]\n  ): xdr.Operation<Operation.InvokeHostFunction> {\n    return Operation.invokeContractFunction({\n      contract: this.address().toString(),\n      function: method,\n      args: params,\n    });\n  }\n\n  /**\n   * Returns the read-only footprint entries necessary for any invocations to\n   * this contract, for convenience when manually adding it to your\n   * transaction's overall footprint or doing bump/restore operations.\n   */\n  getFootprint(): xdr.LedgerKey {\n    return xdr.LedgerKey.contractData(\n      new xdr.LedgerKeyContractData({\n        contract: this.address().toScAddress(),\n        key: xdr.ScVal.scvLedgerKeyContractInstance(),\n        durability: xdr.ContractDataDurability.persistent(),\n      }),\n    );\n  }\n}\n"],"names":["StrKey","Address","Operation","xdr"],"mappings":";;;;;;;AAaO,MAAM,QAAA,CAAS;AAAA,EACZ,GAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY,UAAA,EAAoB;AAC9B,IAAA,IAAI;AAEF,MAAA,IAAA,CAAK,GAAA,GAAMA,aAAA,CAAO,cAAA,CAAe,UAAU,CAAA;AAAA,IAC7C,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,UAAU,CAAA,CAAE,CAAA;AAAA,IACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAA,GAAqB;AACnB,IAAA,OAAOA,aAAA,CAAO,cAAA,CAAe,IAAA,CAAK,GAAG,CAAA;AAAA,EACvC;AAAA;AAAA,EAGA,QAAA,GAAmB;AACjB,IAAA,OAAO,KAAK,UAAA,EAAW;AAAA,EACzB;AAAA;AAAA,EAGA,OAAA,GAAmB;AACjB,IAAA,OAAOC,eAAA,CAAQ,QAAA,CAAS,IAAA,CAAK,GAAG,CAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,IAAA,CACE,WACG,MAAA,EAC0C;AAC7C,IAAA,OAAOC,oBAAU,sBAAA,CAAuB;AAAA,MACtC,QAAA,EAAU,IAAA,CAAK,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,MAClC,QAAA,EAAU,MAAA;AAAA,MACV,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAA,GAA8B;AAC5B,IAAA,OAAOC,uBAAI,SAAA,CAAU,YAAA;AAAA,MACnB,IAAIA,uBAAI,qBAAA,CAAsB;AAAA,QAC5B,QAAA,EAAU,IAAA,CAAK,OAAA,EAAQ,CAAE,WAAA,EAAY;AAAA,QACrC,GAAA,EAAKA,sBAAA,CAAI,KAAA,CAAM,4BAAA,EAA6B;AAAA,QAC5C,UAAA,EAAYA,sBAAA,CAAI,sBAAA,CAAuB,UAAA;AAAW,OACnD;AAAA,KACH;AAAA,EACF;AACF;;;;"}

package/lib/axios/cjs/base/events.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var strkey = require('./strkey.js');
+var scval = require('./scval.js');
+
+function extractEvent(event) {
+  const contractId = typeof event.contractId === "function" ? event.contractId() : null;
+  return {
+    ...contractId !== null && contractId !== void 0 && {
+      contractId: strkey.StrKey.encodeContract(contractId)
+    },
+    type: event.type().name,
+    topics: event.body().value().topics().map((t) => scval.scValToNative(t)),
+    data: scval.scValToNative(event.body().value().data())
+  };
+}
+function humanizeEvents(events) {
+  return events.map((e) => {
+    if ("inSuccessfulContractCall" in e) {
+      return extractEvent(e.event());
+    }
+    return extractEvent(e);
+  });
+}
+
+exports.humanizeEvents = humanizeEvents;
+//# sourceMappingURL=events.js.map

package/lib/axios/cjs/base/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sources":["../../../../src/base/events.ts"],"sourcesContent":["import { StrKey } from \"./strkey.js\";\nimport { scValToNative } from \"./scval.js\";\nimport type { xdr } from \"./index.js\";\n\ninterface SorobanEvent {\n  type: \"contract\" | \"diagnostic\" | \"system\";\n  contractId?: string;\n\n  topics: any[];\n\n  data: any;\n}\n\nfunction extractEvent(event: xdr.ContractEvent): SorobanEvent {\n  const contractId =\n    typeof event.contractId === \"function\" ? event.contractId() : null;\n\n  return {\n    ...(contractId !== null &&\n      contractId !== undefined && {\n        contractId: StrKey.encodeContract(contractId as unknown as Buffer),\n      }),\n    type: event.type().name,\n    topics: event\n      .body()\n      .value()\n      .topics()\n\n      .map((t: xdr.ScVal) => scValToNative(t)),\n\n    data: scValToNative(event.body().value().data()),\n  };\n}\n\n/**\n * Converts raw diagnostic or contract events into something with a flatter,\n * human-readable, and understandable structure.\n *\n * Each element in the returned list has the following properties:\n *  - `type`: one of `'system'`, `'contract'`, `'diagnostic'`\n *  - `contractId`: optionally, a `C...` encoded strkey\n *  - `topics`: a list of {@link scValToNative} invocations on the topics\n *  - `data`: a {@link scValToNative} invocation on the raw event data\n *\n * @param events - either contract events or diagnostic events to parse into a\n *    friendly format\n */\nexport function humanizeEvents(\n  events: xdr.ContractEvent[] | xdr.DiagnosticEvent[],\n): SorobanEvent[] {\n  return events.map((e) => {\n    // A pseudo-instanceof check for xdr.DiagnosticEvent more reliable\n    // in mixed SDK environments:\n    if (\"inSuccessfulContractCall\" in e) {\n      return extractEvent(e.event());\n    }\n\n    return extractEvent(e);\n  });\n}\n"],"names":["StrKey","scValToNative"],"mappings":";;;;;AAaA,SAAS,aAAa,KAAA,EAAwC;AAC5D,EAAA,MAAM,aACJ,OAAO,KAAA,CAAM,eAAe,UAAA,GAAa,KAAA,CAAM,YAAW,GAAI,IAAA;AAEhE,EAAA,OAAO;AAAA,IACL,GAAI,UAAA,KAAe,IAAA,IACjB,UAAA,KAAe,MAAA,IAAa;AAAA,MAC1B,UAAA,EAAYA,aAAA,CAAO,cAAA,CAAe,UAA+B;AAAA,KACnE;AAAA,IACF,IAAA,EAAM,KAAA,CAAM,IAAA,EAAK,CAAE,IAAA;AAAA,IACnB,MAAA,EAAQ,KAAA,CACL,IAAA,EAAK,CACL,KAAA,EAAM,CACN,MAAA,EAAO,CAEP,GAAA,CAAI,CAAC,CAAA,KAAiBC,mBAAA,CAAc,CAAC,CAAC,CAAA;AAAA,IAEzC,IAAA,EAAMA,oBAAc,KAAA,CAAM,IAAA,GAAO,KAAA,EAAM,CAAE,MAAM;AAAA,GACjD;AACF;AAeO,SAAS,eACd,MAAA,EACgB;AAChB,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM;AAGvB,IAAA,IAAI,8BAA8B,CAAA,EAAG;AACnC,MAAA,OAAO,YAAA,CAAa,CAAA,CAAE,KAAA,EAAO,CAAA;AAAA,IAC/B;AAEA,IAAA,OAAO,aAAa,CAAC,CAAA;AAAA,EACvB,CAAC,CAAA;AACH;;;;"}