@stellar/stellar-sdk 16.0.1 → 16.2.0

package/lib/axios/esm/contract/event_spec.d.ts

@@ -0,0 +1,78 @@
+import { xdr } from "../base/index.js";
+import type { Spec } from "./spec.js";
+/**
+ * The result of successfully matching an emitted contract event against one
+ * of the event specs (`xdr.ScSpecEventV0`) defined in a {@link Spec}.
+ *
+ * @see Spec.parseEvent
+ */
+export interface ParsedEvent {
+    /** The name of the matched event (the event spec's declared name). */
+    name: string;
+    /**
+     * All decoded event params, keyed by param name — both the
+     * `topicList`-located params and the data-located ones. Once an event is
+     * parsed, where a param was carried (topic vs data) no longer matters;
+     * the topic list is just a way to mark which fields are indexed.
+     */
+    data: Record<string, any>;
+}
+/**
+ * Gets all the SEP-48 event spec entries (`xdr.ScSpecEntryKind.scSpecEntryEventV0`)
+ * out of a contract's spec entries.
+ *
+ * @param entries - the contract's XDR spec entries
+ * @returns all event entries
+ * @hidden
+ */
+export declare function events(entries: xdr.ScSpecEntry[]): xdr.ScSpecEventV0[];
+/**
+ * Finds the event spec with the given name among a contract's event entries.
+ * A contract may declare several events with the same name (e.g. composed
+ * modules each emitting their own `transfer`); `occurrence` selects among
+ * them, in declaration order.
+ *
+ * @param entries - the contract's XDR spec entries
+ * @param name - the name of the event to find
+ * @param occurrence - 0-based index among the events with that name
+ * @returns the event spec, or `undefined` if the contract declares no event
+ *          with that name (at that occurrence)
+ * @throws if `occurrence` is not a non-negative integer
+ * @hidden
+ */
+export declare function findEvent(entries: xdr.ScSpecEntry[], name: string, occurrence?: number): xdr.ScSpecEventV0 | undefined;
+/**
+ * Attempts to parse an emitted contract event (topics + data ScVals) against
+ * the event specs (SEP-48) contained in a {@link Spec}.
+ *
+ * @param spec - the Spec instance to decode values with (for `scValToNative`)
+ * @param entries - the contract's XDR spec entries
+ * @param topics - the event's topics, as `xdr.ScVal[]` or base64 XDR strings
+ * @param data - the event's data, as an `xdr.ScVal` or a base64 XDR string
+ * @returns the parsed event, or `undefined` if no event spec matches
+ *
+ * Matching compares only the prefix topics and a minimum topic count, so if
+ * two event specs share both (in particular, events with no prefix topics
+ * match on arity alone), the first declared spec whose values decode
+ * successfully wins.
+ * @hidden
+ */
+export declare function parseEvent(spec: Spec, entries: xdr.ScSpecEntry[], topics: xdr.ScVal[] | string[], data: xdr.ScVal | string): ParsedEvent | undefined;
+/**
+ * Builds a `getEvents` topic filter (a single row of `Api.EventFilter.topics`)
+ * for the named event: the event's prefix topics (base64-encoded `scvSymbol`s)
+ * followed by one entry per topic-list param — either the base64-encoded
+ * ScVal for a value supplied in `topicValues`, or the wildcard `"*"`.
+ *
+ * @param spec - the Spec instance to encode values with (for `nativeToScVal`)
+ * @param entries - the contract's XDR spec entries
+ * @param name - the name of the event
+ * @param topicValues - (optional) native values for topic-list params, keyed by param name
+ * @param occurrence - (optional) 0-based index among same-named events, for
+ *        contracts that declare the same event name more than once
+ * @returns a single topic filter row
+ * @throws if no event with the given name (at the given occurrence) exists,
+ *         or if `occurrence` is not a non-negative integer
+ * @hidden
+ */
+export declare function eventTopicFilter(spec: Spec, entries: xdr.ScSpecEntry[], name: string, topicValues?: Record<string, any>, occurrence?: number): string[];

package/lib/axios/esm/contract/event_spec.js

@@ -0,0 +1,159 @@
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
+import 'buffer';
+import types from '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import '../base/keypair.js';
+import 'base32.js';
+import '../base/util/continued_fraction.js';
+import '../base/util/bignumber.js';
+import '../base/transaction_builder.js';
+import '../base/muxed_account.js';
+import '../base/scval.js';
+import '../base/numbers/uint128.js';
+import '../base/numbers/uint256.js';
+import '../base/numbers/int128.js';
+import '../base/numbers/int256.js';
+
+function events(entries) {
+  return entries.filter(
+    (entry) => entry.switch().value === types.ScSpecEntryKind.scSpecEntryEventV0().value
+  ).map((entry) => entry.eventV0());
+}
+function findEvent(entries, name, occurrence = 0) {
+  if (!Number.isInteger(occurrence) || occurrence < 0) {
+    throw new Error(
+      `invalid occurrence for event ${name}: ${occurrence} (expected a non-negative integer)`
+    );
+  }
+  return events(entries).filter((e) => e.name().toString() === name)[occurrence];
+}
+function topicListParams(event) {
+  return event.params().filter(
+    (p) => p.location().value === types.ScSpecEventParamLocationV0.scSpecEventParamLocationTopicList().value
+  );
+}
+function dataParams(event) {
+  return event.params().filter(
+    (p) => p.location().value === types.ScSpecEventParamLocationV0.scSpecEventParamLocationData().value
+  );
+}
+function prefixTopicText(topic) {
+  switch (topic.switch().value) {
+    case types.ScValType.scvSymbol().value:
+      return topic.sym().toString();
+    case types.ScValType.scvString().value:
+      return topic.str().toString();
+    default:
+      return void 0;
+  }
+}
+function matchesTopics(event, topics) {
+  const prefixTopics = event.prefixTopics();
+  const tlParams = topicListParams(event);
+  if (topics.length < prefixTopics.length + tlParams.length) {
+    return void 0;
+  }
+  for (let i = 0; i < prefixTopics.length; i++) {
+    if (prefixTopicText(topics[i]) !== prefixTopics[i].toString()) {
+      return void 0;
+    }
+  }
+  return tlParams;
+}
+function parseEvent(spec, entries, topics, data) {
+  let topicVals;
+  let dataVal;
+  try {
+    topicVals = topics.map(
+      (t) => typeof t === "string" ? types.ScVal.fromXDR(t, "base64") : t
+    );
+    dataVal = typeof data === "string" ? types.ScVal.fromXDR(data, "base64") : data;
+  } catch {
+    return void 0;
+  }
+  const specEvents = events(entries);
+  for (const event of specEvents) {
+    const tlParams = matchesTopics(event, topicVals);
+    if (!tlParams) {
+      continue;
+    }
+    try {
+      const prefixLen = event.prefixTopics().length;
+      const dataOut = /* @__PURE__ */ Object.create(null);
+      tlParams.forEach((param, i) => {
+        const val = topicVals[prefixLen + i];
+        dataOut[param.name().toString()] = spec.scValToNative(
+          val,
+          param.type()
+        );
+      });
+      const dParams = dataParams(event);
+      const format = event.dataFormat().value;
+      if (format === types.ScSpecEventDataFormat.scSpecEventDataFormatSingleValue().value) {
+        const param = dParams[0];
+        if (param) {
+          dataOut[param.name().toString()] = spec.scValToNative(
+            dataVal,
+            param.type()
+          );
+        }
+      } else if (format === types.ScSpecEventDataFormat.scSpecEventDataFormatVec().value) {
+        const vec = dataVal.vec() ?? [];
+        if (vec.length < dParams.length) {
+          continue;
+        }
+        dParams.forEach((param, i) => {
+          dataOut[param.name().toString()] = spec.scValToNative(
+            vec[i],
+            param.type()
+          );
+        });
+      } else if (format === types.ScSpecEventDataFormat.scSpecEventDataFormatMap().value) {
+        const map = dataVal.map() ?? [];
+        dParams.forEach((param) => {
+          const name = param.name().toString();
+          const entry = map.find(
+            (e) => e.key().switch().value === types.ScValType.scvSymbol().value && e.key().sym().toString() === name
+          );
+          if (entry) {
+            dataOut[name] = spec.scValToNative(entry.val(), param.type());
+          }
+        });
+      }
+      return {
+        name: event.name().toString(),
+        data: dataOut
+      };
+    } catch {
+      continue;
+    }
+  }
+  return void 0;
+}
+function eventTopicFilter(spec, entries, name, topicValues, occurrence = 0) {
+  const event = findEvent(entries, name, occurrence);
+  if (!event) {
+    throw new Error(
+      occurrence > 0 ? `no such event: ${name} (occurrence ${occurrence})` : `no such event: ${name}`
+    );
+  }
+  const filter = event.prefixTopics().map((topic) => types.ScVal.scvSymbol(topic.toString()).toXDR("base64"));
+  topicListParams(event).forEach((param) => {
+    const paramName = param.name().toString();
+    if (topicValues && Object.prototype.hasOwnProperty.call(topicValues, paramName)) {
+      const scVal = spec.nativeToScVal(topicValues[paramName], param.type());
+      filter.push(scVal.toXDR("base64"));
+    } else {
+      filter.push("*");
+    }
+  });
+  return filter;
+}
+
+export { eventTopicFilter, events, findEvent, parseEvent };
+//# sourceMappingURL=event_spec.js.map

package/lib/axios/esm/contract/event_spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_spec.js","sources":["../../../../src/contract/event_spec.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport type { Spec } from \"./spec.js\";\n\n/**\n * The result of successfully matching an emitted contract event against one\n * of the event specs (`xdr.ScSpecEventV0`) defined in a {@link Spec}.\n *\n * @see Spec.parseEvent\n */\nexport interface ParsedEvent {\n  /** The name of the matched event (the event spec's declared name). */\n  name: string;\n  /**\n   * All decoded event params, keyed by param name — both the\n   * `topicList`-located params and the data-located ones. Once an event is\n   * parsed, where a param was carried (topic vs data) no longer matters;\n   * the topic list is just a way to mark which fields are indexed.\n   */\n  data: Record<string, any>;\n}\n\n/**\n * Gets all the SEP-48 event spec entries (`xdr.ScSpecEntryKind.scSpecEntryEventV0`)\n * out of a contract's spec entries.\n *\n * @param entries - the contract's XDR spec entries\n * @returns all event entries\n * @hidden\n */\nexport function events(entries: xdr.ScSpecEntry[]): xdr.ScSpecEventV0[] {\n  return entries\n    .filter(\n      (entry) =>\n        entry.switch().value === xdr.ScSpecEntryKind.scSpecEntryEventV0().value,\n    )\n    .map((entry) => entry.eventV0());\n}\n\n/**\n * Finds the event spec with the given name among a contract's event entries.\n * A contract may declare several events with the same name (e.g. composed\n * modules each emitting their own `transfer`); `occurrence` selects among\n * them, in declaration order.\n *\n * @param entries - the contract's XDR spec entries\n * @param name - the name of the event to find\n * @param occurrence - 0-based index among the events with that name\n * @returns the event spec, or `undefined` if the contract declares no event\n *          with that name (at that occurrence)\n * @throws if `occurrence` is not a non-negative integer\n * @hidden\n */\nexport function findEvent(\n  entries: xdr.ScSpecEntry[],\n  name: string,\n  occurrence: number = 0,\n): xdr.ScSpecEventV0 | undefined {\n  if (!Number.isInteger(occurrence) || occurrence < 0) {\n    throw new Error(\n      `invalid occurrence for event ${name}: ${occurrence} (expected a non-negative integer)`,\n    );\n  }\n  return events(entries).filter((e) => e.name().toString() === name)[\n    occurrence\n  ];\n}\n\n/**\n * Returns the topic-list-located params of an event, in declaration order.\n * @hidden\n */\nfunction topicListParams(event: xdr.ScSpecEventV0): xdr.ScSpecEventParamV0[] {\n  return event\n    .params()\n    .filter(\n      (p) =>\n        p.location().value ===\n        xdr.ScSpecEventParamLocationV0.scSpecEventParamLocationTopicList()\n          .value,\n    );\n}\n\n/**\n * Returns the data-located params of an event, in declaration order.\n * @hidden\n */\nfunction dataParams(event: xdr.ScSpecEventV0): xdr.ScSpecEventParamV0[] {\n  return event\n    .params()\n    .filter(\n      (p) =>\n        p.location().value ===\n        xdr.ScSpecEventParamLocationV0.scSpecEventParamLocationData().value,\n    );\n}\n\n/**\n * Reads the text of a prefix topic ScVal. Prefix topics are declared as\n * symbols, but SEP-48 says parsers should also tolerate contracts that emit\n * them as strings, so we accept both `scvSymbol` and `scvString`.\n * @hidden\n */\nfunction prefixTopicText(topic: xdr.ScVal): string | undefined {\n  switch (topic.switch().value) {\n    case xdr.ScValType.scvSymbol().value:\n      return topic.sym().toString();\n    case xdr.ScValType.scvString().value:\n      return topic.str().toString();\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Checks whether the given topics ScVals match an event's prefix topics +\n * topic-list params (matching against the prefix text and a minimum topic\n * count, not the topic-list values).\n *\n * The topic count must be at least `prefixTopics + topicListParams`, not an\n * exact match: some contracts emit trailing topics that the spec deliberately\n * leaves undeclared — e.g. SAC events carry a trailing SEP-11 asset topic.\n * @hidden\n */\nfunction matchesTopics(\n  event: xdr.ScSpecEventV0,\n  topics: xdr.ScVal[],\n): xdr.ScSpecEventParamV0[] | undefined {\n  const prefixTopics = event.prefixTopics();\n  const tlParams = topicListParams(event);\n  if (topics.length < prefixTopics.length + tlParams.length) {\n    return undefined;\n  }\n  for (let i = 0; i < prefixTopics.length; i++) {\n    if (prefixTopicText(topics[i]) !== prefixTopics[i].toString()) {\n      return undefined;\n    }\n  }\n  return tlParams;\n}\n\n/**\n * Attempts to parse an emitted contract event (topics + data ScVals) against\n * the event specs (SEP-48) contained in a {@link Spec}.\n *\n * @param spec - the Spec instance to decode values with (for `scValToNative`)\n * @param entries - the contract's XDR spec entries\n * @param topics - the event's topics, as `xdr.ScVal[]` or base64 XDR strings\n * @param data - the event's data, as an `xdr.ScVal` or a base64 XDR string\n * @returns the parsed event, or `undefined` if no event spec matches\n *\n * Matching compares only the prefix topics and a minimum topic count, so if\n * two event specs share both (in particular, events with no prefix topics\n * match on arity alone), the first declared spec whose values decode\n * successfully wins.\n * @hidden\n */\nexport function parseEvent(\n  spec: Spec,\n  entries: xdr.ScSpecEntry[],\n  topics: xdr.ScVal[] | string[],\n  data: xdr.ScVal | string,\n): ParsedEvent | undefined {\n  let topicVals: xdr.ScVal[];\n  let dataVal: xdr.ScVal;\n  try {\n    topicVals = topics.map((t) =>\n      typeof t === \"string\" ? xdr.ScVal.fromXDR(t, \"base64\") : t,\n    );\n    dataVal =\n      typeof data === \"string\" ? xdr.ScVal.fromXDR(data, \"base64\") : data;\n  } catch {\n    return undefined;\n  }\n\n  const specEvents = events(entries);\n  for (const event of specEvents) {\n    const tlParams = matchesTopics(event, topicVals);\n    if (!tlParams) {\n      continue;\n    }\n\n    // Topic matching is fuzzy (prefix symbols + arity only), so a candidate\n    // event may still turn out not to fit once its values are decoded — e.g.\n    // an unrelated contract's event sharing the same prefix and topic count.\n    // Treat any decode failure as a non-match and try the next candidate.\n    try {\n      const prefixLen = event.prefixTopics().length;\n      // Param names come from an untrusted, on-chain contract spec, so a\n      // param literally named \"__proto__\" must not be able to reach the\n      // object's prototype via normal property assignment. A null-prototype\n      // object stores it as a plain own property instead.\n      const dataOut: Record<string, any> = Object.create(null);\n      tlParams.forEach((param, i) => {\n        const val = topicVals[prefixLen + i];\n        dataOut[param.name().toString()] = spec.scValToNative(\n          val,\n          param.type(),\n        );\n      });\n\n      const dParams = dataParams(event);\n      const format = event.dataFormat().value;\n      if (\n        format ===\n        xdr.ScSpecEventDataFormat.scSpecEventDataFormatSingleValue().value\n      ) {\n        const param = dParams[0];\n        if (param) {\n          dataOut[param.name().toString()] = spec.scValToNative(\n            dataVal,\n            param.type(),\n          );\n        }\n      } else if (\n        format === xdr.ScSpecEventDataFormat.scSpecEventDataFormatVec().value\n      ) {\n        const vec = dataVal.vec() ?? [];\n        if (vec.length < dParams.length) {\n          continue;\n        }\n        dParams.forEach((param, i) => {\n          dataOut[param.name().toString()] = spec.scValToNative(\n            vec[i],\n            param.type(),\n          );\n        });\n      } else if (\n        format === xdr.ScSpecEventDataFormat.scSpecEventDataFormatMap().value\n      ) {\n        const map = dataVal.map() ?? [];\n        dParams.forEach((param) => {\n          const name = param.name().toString();\n          const entry = map.find(\n            (e) =>\n              e.key().switch().value === xdr.ScValType.scvSymbol().value &&\n              e.key().sym().toString() === name,\n          );\n          if (entry) {\n            dataOut[name] = spec.scValToNative(entry.val(), param.type());\n          }\n        });\n      }\n\n      return {\n        name: event.name().toString(),\n        data: dataOut,\n      };\n    } catch {\n      continue;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Builds a `getEvents` topic filter (a single row of `Api.EventFilter.topics`)\n * for the named event: the event's prefix topics (base64-encoded `scvSymbol`s)\n * followed by one entry per topic-list param — either the base64-encoded\n * ScVal for a value supplied in `topicValues`, or the wildcard `\"*\"`.\n *\n * @param spec - the Spec instance to encode values with (for `nativeToScVal`)\n * @param entries - the contract's XDR spec entries\n * @param name - the name of the event\n * @param topicValues - (optional) native values for topic-list params, keyed by param name\n * @param occurrence - (optional) 0-based index among same-named events, for\n *        contracts that declare the same event name more than once\n * @returns a single topic filter row\n * @throws if no event with the given name (at the given occurrence) exists,\n *         or if `occurrence` is not a non-negative integer\n * @hidden\n */\nexport function eventTopicFilter(\n  spec: Spec,\n  entries: xdr.ScSpecEntry[],\n  name: string,\n  topicValues?: Record<string, any>,\n  occurrence: number = 0,\n): string[] {\n  const event = findEvent(entries, name, occurrence);\n  if (!event) {\n    throw new Error(\n      occurrence > 0\n        ? `no such event: ${name} (occurrence ${occurrence})`\n        : `no such event: ${name}`,\n    );\n  }\n  const filter: string[] = event\n    .prefixTopics()\n    .map((topic) => xdr.ScVal.scvSymbol(topic.toString()).toXDR(\"base64\"));\n\n  topicListParams(event).forEach((param) => {\n    const paramName = param.name().toString();\n    if (\n      topicValues &&\n      Object.prototype.hasOwnProperty.call(topicValues, paramName)\n    ) {\n      const scVal = spec.nativeToScVal(topicValues[paramName], param.type());\n      filter.push(scVal.toXDR(\"base64\"));\n    } else {\n      filter.push(\"*\");\n    }\n  });\n\n  return filter;\n}\n"],"names":["xdr"],"mappings":"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"}

package/lib/axios/esm/contract/index.d.ts

@@ -1,7 +1,10 @@
 export * from "./assembled_transaction.js";
 export * from "./basic_node_signer.js";
 export * from "./client.js";
+export type { ParsedEvent } from "./event_spec.js";
 export * from "./rust_result.js";
 export * from "./sent_transaction.js";
+export { KeypairSigner } from "./signer.js";
+export type { Signer, SignTransactionLike, SignAuthEntryLike, } from "./signer.js";
 export * from "./spec.js";
 export * from "./types.js";

package/lib/axios/esm/contract/index.js

@@ -3,6 +3,7 @@ export { basicNodeSigner } from './basic_node_signer.js';
 export { Client } from './client.js';
 export { Err, Ok } from './rust_result.js';
 export { SentTransaction, Watcher } from './sent_transaction.js';
+export { KeypairSigner } from './signer.js';
 export { Spec } from './spec.js';
 export { DEFAULT_TIMEOUT, NULL_ACCOUNT } from './types.js';
 //# sourceMappingURL=index.js.map

package/lib/axios/esm/contract/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/lib/axios/esm/contract/sent_transaction.js

@@ -1,25 +1,5 @@
 import { Api } from '../rpc/api.js';
 import { RpcServer } from '../rpc/server.js';
-import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
-import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
-import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
-import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
-import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
-import 'buffer';
-import '../base/generated/curr_generated.js';
-import '@noble/hashes/sha2.js';
-import '../base/signing.js';
-import '../base/keypair.js';
-import 'base32.js';
-import '../base/util/continued_fraction.js';
-import '../base/util/bignumber.js';
-import '../base/transaction_builder.js';
-import '../base/muxed_account.js';
-import '../base/scval.js';
-import '../base/numbers/uint128.js';
-import '../base/numbers/uint256.js';
-import '../base/numbers/int128.js';
-import '../base/numbers/int256.js';
 import { withExponentialBackoff } from './utils.js';
 import { DEFAULT_TIMEOUT } from './types.js';
 

package/lib/axios/esm/contract/sent_transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"sent_transaction.js","sources":["../../../../src/contract/sent_transaction.ts"],"sourcesContent":["/* disable max-classes rule, because extending error shouldn't count! */\n/* eslint max-classes-per-file: 0 */\nimport type { MethodOptions } from \"./types.js\";\nimport { Server } from \"../rpc/index.js\";\nimport { Api } from \"../rpc/api.js\";\nimport { withExponentialBackoff } from \"./utils.js\";\nimport { DEFAULT_TIMEOUT } from \"./types.js\";\nimport type { AssembledTransaction } from \"./assembled_transaction.js\";\n\n/**\n * A transaction that has been sent to the Soroban network. This happens in two steps:\n *\n * 1. `sendTransaction`: initial submission of the transaction to the network.\n *    If this step runs into problems, the attempt to sign and send will be\n *    aborted. You can see the result of this call in the\n *    `sendTransactionResponse` getter.\n * 2. `getTransaction`: once the transaction has been submitted to the network\n *    successfully, you need to wait for it to finalize to get the result of the\n *    transaction. This will be retried with exponential backoff for\n *    {@link MethodOptions.timeoutInSeconds} seconds. See all attempts in\n *    `getTransactionResponseAll` and the most recent attempt in\n *    `getTransactionResponse`.\n *\n *\n * @param signTransaction - More info in {@link MethodOptions}\n * @param assembled - {@link AssembledTransaction} from which this SentTransaction was initialized\n */\nexport class SentTransaction<T> {\n  public server: Server;\n\n  /**\n   * The result of calling `sendTransaction` to broadcast the transaction to the\n   * network.\n   */\n  public sendTransactionResponse?: Api.SendTransactionResponse;\n\n  /**\n   * If `sendTransaction` completes successfully (which means it has `status: 'PENDING'`),\n   * then `getTransaction` will be called in a loop for\n   * {@link MethodOptions.timeoutInSeconds} seconds. This array contains all\n   * the results of those calls.\n   */\n  public getTransactionResponseAll?: Api.GetTransactionResponse[];\n\n  /**\n   * The most recent result of calling `getTransaction`, from the\n   * `getTransactionResponseAll` array.\n   */\n  public getTransactionResponse?: Api.GetTransactionResponse;\n\n  static Errors = {\n    SendFailed: class SendFailedError extends Error {},\n    SendResultOnly: class SendResultOnlyError extends Error {},\n    TransactionStillPending: class TransactionStillPendingError extends Error {},\n  };\n\n  constructor(public assembled: AssembledTransaction<T>) {\n    const { server, allowHttp, headers, rpcUrl } = this.assembled.options;\n    this.server = server ?? new Server(rpcUrl, { allowHttp, headers });\n  }\n\n  /**\n   * Initialize a `SentTransaction` from {@link AssembledTransaction}\n   * `assembled`, passing an optional {@link Watcher} `watcher`. This will also\n   * send the transaction to the network.\n   */\n  static init = async <U>(\n    /** {@link AssembledTransaction} from which this SentTransaction was initialized */\n    assembled: AssembledTransaction<U>,\n    watcher?: Watcher,\n  ): Promise<SentTransaction<U>> => {\n    const tx = new SentTransaction(assembled);\n    const sent = await tx.send(watcher);\n    return sent;\n  };\n\n  private send = async (watcher?: Watcher): Promise<this> => {\n    this.sendTransactionResponse = await this.server.sendTransaction(\n      this.assembled.signed!,\n    );\n\n    if (this.sendTransactionResponse.status !== \"PENDING\") {\n      throw new SentTransaction.Errors.SendFailed(\n        `Sending the transaction to the network failed!\\n${JSON.stringify(\n          this.sendTransactionResponse,\n          null,\n          2,\n        )}`,\n      );\n    }\n\n    if (watcher?.onSubmitted) watcher.onSubmitted(this.sendTransactionResponse);\n\n    const { hash } = this.sendTransactionResponse;\n\n    const timeoutInSeconds =\n      this.assembled.options.timeoutInSeconds ?? DEFAULT_TIMEOUT;\n    this.getTransactionResponseAll = await withExponentialBackoff(\n      async () => {\n        const tx = await this.server.getTransaction(hash);\n        if (watcher?.onProgress) watcher.onProgress(tx);\n        return tx;\n      },\n      (resp) => resp.status === Api.GetTransactionStatus.NOT_FOUND,\n      timeoutInSeconds,\n    );\n\n    this.getTransactionResponse =\n      this.getTransactionResponseAll[this.getTransactionResponseAll.length - 1];\n    if (\n      this.getTransactionResponse.status === Api.GetTransactionStatus.NOT_FOUND\n    ) {\n      throw new SentTransaction.Errors.TransactionStillPending(\n        `Waited ${timeoutInSeconds} seconds for transaction to complete, but it did not. ` +\n          `Returning anyway. Check the transaction status manually. ` +\n          `Sent transaction: ${JSON.stringify(\n            this.sendTransactionResponse,\n            null,\n            2,\n          )}\\n` +\n          `All attempts to get the result: ${JSON.stringify(\n            this.getTransactionResponseAll,\n            null,\n            2,\n          )}`,\n      );\n    }\n\n    return this;\n  };\n\n  get result(): T {\n    // 1. check if transaction was submitted and awaited with `getTransaction`\n    if (\"getTransactionResponse\" in this && this.getTransactionResponse) {\n      // getTransactionResponse has a `returnValue` field unless it failed\n      if (\"returnValue\" in this.getTransactionResponse) {\n        return this.assembled.options.parseResultXdr(\n          this.getTransactionResponse.returnValue!,\n        );\n      }\n\n      // if \"returnValue\" not present, the transaction failed; return without\n      // parsing the result\n      throw new Error(\"Transaction failed! Cannot parse result.\");\n    }\n\n    // 2. otherwise, maybe it was merely sent with `sendTransaction`\n    if (this.sendTransactionResponse) {\n      const errorResult = this.sendTransactionResponse.errorResult?.result();\n      if (errorResult) {\n        throw new SentTransaction.Errors.SendFailed(\n          `Transaction simulation looked correct, but attempting to send the transaction failed. Check \\`simulation\\` and \\`sendTransactionResponseAll\\` to troubleshoot. Decoded \\`sendTransactionResponse.errorResultXdr\\`: ${errorResult}`,\n        );\n      }\n      throw new SentTransaction.Errors.SendResultOnly(\n        `Transaction was sent to the network, but not yet awaited. No result to show. Await transaction completion with \\`getTransaction(sendTransactionResponse.hash)\\``,\n      );\n    }\n\n    // 3. finally, if neither of those are present, throw an error\n    throw new Error(\n      `Sending transaction failed: ${JSON.stringify(this.assembled.signed)}`,\n    );\n  }\n}\n\nexport abstract class Watcher {\n  /**\n   * Function to call after transaction has been submitted successfully to\n   * the network for processing\n   */\n  abstract onSubmitted?(response?: Api.SendTransactionResponse): void;\n\n  /**\n   * Function to call every time the submitted transaction's status is\n   * checked while awaiting its full inclusion in the ledger\n   */\n  abstract onProgress?(response?: Api.GetTransactionResponse): void;\n}\n"],"names":["Server"],"mappings":"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"}
+{"version":3,"file":"sent_transaction.js","sources":["../../../../src/contract/sent_transaction.ts"],"sourcesContent":["/* disable max-classes rule, because extending error shouldn't count! */\n/* eslint max-classes-per-file: 0 */\nimport type { MethodOptions } from \"./types.js\";\nimport { Server } from \"../rpc/index.js\";\nimport { Api } from \"../rpc/api.js\";\nimport { withExponentialBackoff } from \"./utils.js\";\nimport { DEFAULT_TIMEOUT } from \"./types.js\";\nimport type { AssembledTransaction } from \"./assembled_transaction.js\";\n\n/**\n * A transaction that has been sent to the Soroban network. This happens in two steps:\n *\n * 1. `sendTransaction`: initial submission of the transaction to the network.\n *    If this step runs into problems, the attempt to sign and send will be\n *    aborted. You can see the result of this call in the\n *    `sendTransactionResponse` getter.\n * 2. `getTransaction`: once the transaction has been submitted to the network\n *    successfully, you need to wait for it to finalize to get the result of the\n *    transaction. This will be retried with exponential backoff for\n *    {@link MethodOptions.timeoutInSeconds} seconds. See all attempts in\n *    `getTransactionResponseAll` and the most recent attempt in\n *    `getTransactionResponse`.\n *\n *\n * @param signTransaction - More info in {@link MethodOptions}\n * @param assembled - {@link AssembledTransaction} from which this SentTransaction was initialized\n */\nexport class SentTransaction<T> {\n  public server: Server;\n\n  /**\n   * The result of calling `sendTransaction` to broadcast the transaction to the\n   * network.\n   */\n  public sendTransactionResponse?: Api.SendTransactionResponse;\n\n  /**\n   * If `sendTransaction` completes successfully (which means it has `status: 'PENDING'`),\n   * then `getTransaction` will be called in a loop for\n   * {@link MethodOptions.timeoutInSeconds} seconds. This array contains all\n   * the results of those calls.\n   */\n  public getTransactionResponseAll?: Api.GetTransactionResponse[];\n\n  /**\n   * The most recent result of calling `getTransaction`, from the\n   * `getTransactionResponseAll` array.\n   */\n  public getTransactionResponse?: Api.GetTransactionResponse;\n\n  static Errors = {\n    SendFailed: class SendFailedError extends Error {},\n    SendResultOnly: class SendResultOnlyError extends Error {},\n    TransactionStillPending: class TransactionStillPendingError extends Error {},\n  };\n\n  constructor(public assembled: AssembledTransaction<T>) {\n    const { server, allowHttp, headers, rpcUrl } = this.assembled.options;\n    this.server = server ?? new Server(rpcUrl, { allowHttp, headers });\n  }\n\n  /**\n   * Initialize a `SentTransaction` from {@link AssembledTransaction}\n   * `assembled`, passing an optional {@link Watcher} `watcher`. This will also\n   * send the transaction to the network.\n   */\n  static init = async <U>(\n    /** {@link AssembledTransaction} from which this SentTransaction was initialized */\n    assembled: AssembledTransaction<U>,\n    watcher?: Watcher,\n  ): Promise<SentTransaction<U>> => {\n    const tx = new SentTransaction(assembled);\n    const sent = await tx.send(watcher);\n    return sent;\n  };\n\n  private send = async (watcher?: Watcher): Promise<this> => {\n    this.sendTransactionResponse = await this.server.sendTransaction(\n      this.assembled.signed!,\n    );\n\n    if (this.sendTransactionResponse.status !== \"PENDING\") {\n      throw new SentTransaction.Errors.SendFailed(\n        `Sending the transaction to the network failed!\\n${JSON.stringify(\n          this.sendTransactionResponse,\n          null,\n          2,\n        )}`,\n      );\n    }\n\n    if (watcher?.onSubmitted) watcher.onSubmitted(this.sendTransactionResponse);\n\n    const { hash } = this.sendTransactionResponse;\n\n    const timeoutInSeconds =\n      this.assembled.options.timeoutInSeconds ?? DEFAULT_TIMEOUT;\n    this.getTransactionResponseAll = await withExponentialBackoff(\n      async () => {\n        const tx = await this.server.getTransaction(hash);\n        if (watcher?.onProgress) watcher.onProgress(tx);\n        return tx;\n      },\n      (resp) => resp.status === Api.GetTransactionStatus.NOT_FOUND,\n      timeoutInSeconds,\n    );\n\n    this.getTransactionResponse =\n      this.getTransactionResponseAll[this.getTransactionResponseAll.length - 1];\n    if (\n      this.getTransactionResponse.status === Api.GetTransactionStatus.NOT_FOUND\n    ) {\n      throw new SentTransaction.Errors.TransactionStillPending(\n        `Waited ${timeoutInSeconds} seconds for transaction to complete, but it did not. ` +\n          `Returning anyway. Check the transaction status manually. ` +\n          `Sent transaction: ${JSON.stringify(\n            this.sendTransactionResponse,\n            null,\n            2,\n          )}\\n` +\n          `All attempts to get the result: ${JSON.stringify(\n            this.getTransactionResponseAll,\n            null,\n            2,\n          )}`,\n      );\n    }\n\n    return this;\n  };\n\n  get result(): T {\n    // 1. check if transaction was submitted and awaited with `getTransaction`\n    if (\"getTransactionResponse\" in this && this.getTransactionResponse) {\n      // getTransactionResponse has a `returnValue` field unless it failed\n      if (\"returnValue\" in this.getTransactionResponse) {\n        return this.assembled.options.parseResultXdr(\n          this.getTransactionResponse.returnValue!,\n        );\n      }\n\n      // if \"returnValue\" not present, the transaction failed; return without\n      // parsing the result\n      throw new Error(\"Transaction failed! Cannot parse result.\");\n    }\n\n    // 2. otherwise, maybe it was merely sent with `sendTransaction`\n    if (this.sendTransactionResponse) {\n      const errorResult = this.sendTransactionResponse.errorResult?.result();\n      if (errorResult) {\n        throw new SentTransaction.Errors.SendFailed(\n          `Transaction simulation looked correct, but attempting to send the transaction failed. Check \\`simulation\\` and \\`sendTransactionResponseAll\\` to troubleshoot. Decoded \\`sendTransactionResponse.errorResultXdr\\`: ${errorResult}`,\n        );\n      }\n      throw new SentTransaction.Errors.SendResultOnly(\n        `Transaction was sent to the network, but not yet awaited. No result to show. Await transaction completion with \\`getTransaction(sendTransactionResponse.hash)\\``,\n      );\n    }\n\n    // 3. finally, if neither of those are present, throw an error\n    throw new Error(\n      `Sending transaction failed: ${JSON.stringify(this.assembled.signed)}`,\n    );\n  }\n}\n\nexport abstract class Watcher {\n  /**\n   * Function to call after transaction has been submitted successfully to\n   * the network for processing\n   */\n  abstract onSubmitted?(response?: Api.SendTransactionResponse): void;\n\n  /**\n   * Function to call every time the submitted transaction's status is\n   * checked while awaiting its full inclusion in the ledger\n   */\n  abstract onProgress?(response?: Api.GetTransactionResponse): void;\n}\n"],"names":["Server"],"mappings":";;;;;AA2BO,MAAM,eAAA,CAAmB;AAAA,EA6B9B,YAAmB,SAAA,EAAoC;AAApC,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AACjB,IAAA,MAAM,EAAE,MAAA,EAAQ,SAAA,EAAW,SAAS,MAAA,EAAO,GAAI,KAAK,SAAA,CAAU,OAAA;AAC9D,IAAA,IAAA,CAAK,MAAA,GAAS,UAAU,IAAIA,SAAA,CAAO,QAAQ,EAAE,SAAA,EAAW,SAAS,CAAA;AAAA,EACnE;AAAA,EAHmB,SAAA;AAAA,EA5BZ,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,uBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,yBAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,sBAAA;AAAA,EAEP,OAAO,MAAA,GAAS;AAAA,IACd,UAAA,EAAY,MAAM,eAAA,SAAwB,KAAA,CAAM;AAAA,KAAC;AAAA,IACjD,cAAA,EAAgB,MAAM,mBAAA,SAA4B,KAAA,CAAM;AAAA,KAAC;AAAA,IACzD,uBAAA,EAAyB,MAAM,4BAAA,SAAqC,KAAA,CAAM;AAAA;AAAC,GAC7E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAO,IAAA,GAAO,OAEZ,SAAA,EACA,OAAA,KACgC;AAChC,IAAA,MAAM,EAAA,GAAK,IAAI,eAAA,CAAgB,SAAS,CAAA;AACxC,IAAA,MAAM,IAAA,GAAO,MAAM,EAAA,CAAG,IAAA,CAAK,OAAO,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAAA,EAEQ,IAAA,GAAO,OAAO,OAAA,KAAqC;AACzD,IAAA,IAAA,CAAK,uBAAA,GAA0B,MAAM,IAAA,CAAK,MAAA,CAAO,eAAA;AAAA,MAC/C,KAAK,SAAA,CAAU;AAAA,KACjB;AAEA,IAAA,IAAI,IAAA,CAAK,uBAAA,CAAwB,MAAA,KAAW,SAAA,EAAW;AACrD,MAAA,MAAM,IAAI,gBAAgB,MAAA,CAAO,UAAA;AAAA,QAC/B,CAAA;AAAA,EAAmD,IAAA,CAAK,SAAA;AAAA,UACtD,IAAA,CAAK,uBAAA;AAAA,UACL,IAAA;AAAA,UACA;AAAA,SACD,CAAA;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,OAAA,EAAS,WAAA,EAAa,OAAA,CAAQ,WAAA,CAAY,KAAK,uBAAuB,CAAA;AAE1E,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,IAAA,CAAK,uBAAA;AAEtB,IAAA,MAAM,gBAAA,GACJ,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,gBAAA,IAAoB,eAAA;AAC7C,IAAA,IAAA,CAAK,4BAA4B,MAAM,sBAAA;AAAA,MACrC,YAAY;AACV,QAAA,MAAM,EAAA,GAAK,MAAM,IAAA,CAAK,MAAA,CAAO,eAAe,IAAI,CAAA;AAChD,QAAA,IAAI,OAAA,EAAS,UAAA,EAAY,OAAA,CAAQ,UAAA,CAAW,EAAE,CAAA;AAC9C,QAAA,OAAO,EAAA;AAAA,MACT,CAAA;AAAA,MACA,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,KAAW,IAAI,oBAAA,CAAqB,SAAA;AAAA,MACnD;AAAA,KACF;AAEA,IAAA,IAAA,CAAK,yBACH,IAAA,CAAK,yBAAA,CAA0B,IAAA,CAAK,yBAAA,CAA0B,SAAS,CAAC,CAAA;AAC1E,IAAA,IACE,IAAA,CAAK,sBAAA,CAAuB,MAAA,KAAW,GAAA,CAAI,qBAAqB,SAAA,EAChE;AACA,MAAA,MAAM,IAAI,gBAAgB,MAAA,CAAO,uBAAA;AAAA,QAC/B,CAAA,OAAA,EAAU,gBAAgB,CAAA,iIAAA,EAEH,IAAA,CAAK,SAAA;AAAA,UACxB,IAAA,CAAK,uBAAA;AAAA,UACL,IAAA;AAAA,UACA;AAAA,SACD;AAAA,gCAAA,EACkC,IAAA,CAAK,SAAA;AAAA,UACtC,IAAA,CAAK,yBAAA;AAAA,UACL,IAAA;AAAA,UACA;AAAA,SACD,CAAA;AAAA,OACL;AAAA,IACF;AAEA,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAAA,EAEA,IAAI,MAAA,GAAY;AAEd,IAAA,IAAI,wBAAA,IAA4B,IAAA,IAAQ,IAAA,CAAK,sBAAA,EAAwB;AAEnE,MAAA,IAAI,aAAA,IAAiB,KAAK,sBAAA,EAAwB;AAChD,QAAA,OAAO,IAAA,CAAK,UAAU,OAAA,CAAQ,cAAA;AAAA,UAC5B,KAAK,sBAAA,CAAuB;AAAA,SAC9B;AAAA,MACF;AAIA,MAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,IAC5D;AAGA,IAAA,IAAI,KAAK,uBAAA,EAAyB;AAChC,MAAA,MAAM,WAAA,GAAc,IAAA,CAAK,uBAAA,CAAwB,WAAA,EAAa,MAAA,EAAO;AACrE,MAAA,IAAI,WAAA,EAAa;AACf,QAAA,MAAM,IAAI,gBAAgB,MAAA,CAAO,UAAA;AAAA,UAC/B,sNAAsN,WAAW,CAAA;AAAA,SACnO;AAAA,MACF;AACA,MAAA,MAAM,IAAI,gBAAgB,MAAA,CAAO,cAAA;AAAA,QAC/B,CAAA,+JAAA;AAAA,OACF;AAAA,IACF;AAGA,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,+BAA+B,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,SAAA,CAAU,MAAM,CAAC,CAAA;AAAA,KACtE;AAAA,EACF;AACF;AAEO,MAAe,OAAA,CAAQ;AAY9B;;;;"}

package/lib/axios/esm/contract/signer.d.ts

@@ -0,0 +1,104 @@
+import { Keypair } from "../base/index.js";
+import type { SignAuthEntry, SignTransaction } from "./types.js";
+/**
+ * A signing identity: something that can sign, and that knows who it is.
+ *
+ * A bare {@link SignTransaction} callback carries no identity, so callers have
+ * to pass the signer's address alongside it and keep the two in sync. A
+ * `Signer` bundles them.
+ *
+ * `address` is deliberately a plain string rather than an Ed25519 public key:
+ * it is a `G…` account address for keypair-backed signers, but may be a `C…`
+ * contract address for smart accounts, whose signatures are not Ed25519 at all.
+ *
+ * `signTransaction` and `signAuthEntry` keep the exact shapes the SDK already
+ * accepts (those of SEP-43 wallets such as Freighter), so an existing wallet
+ * object becomes a `Signer` by gaining an `address`.
+ *
+ * `signAuthEntry` is optional because not every wallet implements it; it is
+ * only needed for multi-party (non-invoker) auth entry signing.
+ *
+ * Accepted wherever the SDK takes a signing callback: the `signTransaction` and
+ * `signAuthEntry` options on `ClientOptions` and `MethodOptions`, and the
+ * per-call overrides on `AssembledTransaction`'s `sign`, `signAndSend`, and
+ * `signAuthEntries`.
+ */
+export interface Signer {
+    /** The address this signer signs as: `G…` for accounts, `C…` for contracts. */
+    readonly address: string;
+    /** Signs a transaction envelope. Matches `signTransaction` from Freighter. */
+    signTransaction: SignTransaction;
+    /** Signs an auth entry preimage. Matches `signAuthEntry` from Freighter. */
+    signAuthEntry?: SignAuthEntry;
+}
+/**
+ * A {@link Signer} backed by a local {@link Keypair}.
+ *
+ * Suitable for Node applications, scripts, and tests — anywhere the secret key
+ * lives in the same process. For browser applications, use the SEP-43 wallet's
+ * own `signTransaction`, or wrap it in an object satisfying {@link Signer}.
+ *
+ * @example
+ * ```ts
+ * import { Keypair } from "@stellar/stellar-sdk";
+ * import { Client, KeypairSigner } from "@stellar/stellar-sdk/contract";
+ *
+ * const keypair = Keypair.fromSecret(secret);
+ * const client = await Client.from({
+ *   contractId,
+ *   networkPassphrase,
+ *   rpcUrl,
+ *   publicKey: keypair.publicKey(),
+ *   signTransaction: new KeypairSigner(keypair, networkPassphrase),
+ * });
+ * ```
+ */
+export declare class KeypairSigner implements Signer {
+    private readonly keypair;
+    private readonly networkPassphrase;
+    /**
+     * The keypair's Ed25519 account address (`G…`), always `keypair.publicKey()`.
+     */
+    readonly address: string;
+    /**
+     * @param keypair - the {@link Keypair} to sign with. Signing throws
+     *    `cannot sign: no secret key available` if it holds only a public key.
+     * @param networkPassphrase - passphrase of the network to sign for, used
+     *    whenever the caller does not pass one at signing time
+     */
+    constructor(keypair: Keypair, networkPassphrase: string);
+    signTransaction: SignTransaction;
+    signAuthEntry: SignAuthEntry;
+}
+/**
+ * Anything accepted where a `signTransaction` callback is expected: the raw
+ * SEP-43 callback, a {@link Signer}, or a {@link Keypair}.
+ */
+export type SignTransactionLike = SignTransaction | Signer | Keypair;
+/**
+ * Anything accepted where a `signAuthEntry` callback is expected: the raw
+ * SEP-43 callback, a {@link Signer}, or a {@link Keypair}.
+ */
+export type SignAuthEntryLike = SignAuthEntry | Signer | Keypair;
+/**
+ * Reduces the accepted signing shapes down to a plain callback.
+ *
+ * Anything that carries no usable callback yields `undefined` — including an
+ * absent value, or an object that does not match any accepted shape — so the
+ * caller decides how to report a missing signer. This is deliberately lenient:
+ * callers reaching the SDK from plain JavaScript are not held to the types, and
+ * a clear `NoSigner` beats a `TypeError` from deep inside a normalizer.
+ *
+ * Internal: called at the entry points that read a caller-supplied signer, so
+ * the rest of the code only ever deals with a `SignTransaction`.
+ */
+export declare function toSignTransaction(value: SignTransactionLike | undefined, networkPassphrase: string): SignTransaction | undefined;
+/**
+ * Reduces the accepted signing shapes down to a plain callback.
+ *
+ * A {@link Signer} whose optional `signAuthEntry` is absent yields `undefined`,
+ * so the caller reports it the same way it reports a missing option.
+ *
+ * Internal: see {@link toSignTransaction}.
+ */
+export declare function toSignAuthEntry(value: SignAuthEntryLike | undefined, networkPassphrase: string): SignAuthEntry | undefined;

package/lib/axios/esm/contract/signer.js

@@ -0,0 +1,91 @@
+import { Buffer } from 'buffer';
+import { TransactionBuilder } from '../base/transaction_builder.js';
+import { hash } from '../base/hashing.js';
+
+class KeypairSigner {
+  /**
+   * @param keypair - the {@link Keypair} to sign with. Signing throws
+   *    `cannot sign: no secret key available` if it holds only a public key.
+   * @param networkPassphrase - passphrase of the network to sign for, used
+   *    whenever the caller does not pass one at signing time
+   */
+  constructor(keypair, networkPassphrase) {
+    this.keypair = keypair;
+    this.networkPassphrase = networkPassphrase;
+    this.address = keypair.publicKey();
+  }
+  keypair;
+  networkPassphrase;
+  /**
+   * The keypair's Ed25519 account address (`G…`), always `keypair.publicKey()`.
+   */
+  address;
+  /* Arrow instance properties rather than prototype methods because
+       `basicNodeSigner` destructures them into a plain object, which would lose
+       `this` on a prototype method. (The normalizers below tolerate either, since
+       they bind what they extract.)
+  
+       They stay `async` despite having nothing to await (hence the rule
+       suppressions): that way a synchronous failure — malformed XDR, or a keypair
+       holding no secret key — rejects the returned promise instead of throwing,
+       preserving the behavior `basicNodeSigner` had before it delegated here. */
+  // eslint-disable-next-line @typescript-eslint/require-await
+  signTransaction = async (xdr, opts) => {
+    const t = TransactionBuilder.fromXDR(
+      xdr,
+      opts?.networkPassphrase || this.networkPassphrase
+    );
+    t.sign(this.keypair);
+    return {
+      signedTxXdr: t.toXDR(),
+      signerAddress: this.address
+    };
+  };
+  // eslint-disable-next-line @typescript-eslint/require-await
+  signAuthEntry = async (authEntry) => {
+    const signedAuthEntry = this.keypair.sign(hash(Buffer.from(authEntry, "base64"))).toString("base64");
+    return {
+      signedAuthEntry,
+      signerAddress: this.address
+    };
+  };
+}
+function isKeypairLike(value) {
+  return "publicKey" in value && typeof value.publicKey === "function" && "sign" in value && typeof value.sign === "function" && "signDecorated" in value && typeof value.signDecorated === "function";
+}
+function signerAddress(value) {
+  if (value == null || typeof value !== "object") return void 0;
+  if ("signTransaction" in value && typeof value.address === "string") {
+    return value.address;
+  }
+  return isKeypairLike(value) ? value.publicKey() : void 0;
+}
+function toSignTransaction(value, networkPassphrase) {
+  if (value == null) return void 0;
+  if (typeof value === "function") return value;
+  if (typeof value !== "object") return void 0;
+  if ("signTransaction" in value) {
+    const fn = value.signTransaction;
+    return typeof fn === "function" ? fn.bind(value) : void 0;
+  }
+  if (isKeypairLike(value)) {
+    return new KeypairSigner(value, networkPassphrase).signTransaction;
+  }
+  return void 0;
+}
+function toSignAuthEntry(value, networkPassphrase) {
+  if (value == null) return void 0;
+  if (typeof value === "function") return value;
+  if (typeof value !== "object") return void 0;
+  if ("signTransaction" in value) {
+    const fn = value.signAuthEntry;
+    return typeof fn === "function" ? fn.bind(value) : void 0;
+  }
+  if (isKeypairLike(value)) {
+    return new KeypairSigner(value, networkPassphrase).signAuthEntry;
+  }
+  return void 0;
+}
+
+export { KeypairSigner, signerAddress, toSignAuthEntry, toSignTransaction };
+//# sourceMappingURL=signer.js.map

package/lib/axios/esm/contract/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sources":["../../../../src/contract/signer.ts"],"sourcesContent":["import { Keypair, TransactionBuilder, hash } from \"../base/index.js\";\nimport type { SignAuthEntry, SignTransaction } from \"./types.js\";\n\n/**\n * A signing identity: something that can sign, and that knows who it is.\n *\n * A bare {@link SignTransaction} callback carries no identity, so callers have\n * to pass the signer's address alongside it and keep the two in sync. A\n * `Signer` bundles them.\n *\n * `address` is deliberately a plain string rather than an Ed25519 public key:\n * it is a `G…` account address for keypair-backed signers, but may be a `C…`\n * contract address for smart accounts, whose signatures are not Ed25519 at all.\n *\n * `signTransaction` and `signAuthEntry` keep the exact shapes the SDK already\n * accepts (those of SEP-43 wallets such as Freighter), so an existing wallet\n * object becomes a `Signer` by gaining an `address`.\n *\n * `signAuthEntry` is optional because not every wallet implements it; it is\n * only needed for multi-party (non-invoker) auth entry signing.\n *\n * Accepted wherever the SDK takes a signing callback: the `signTransaction` and\n * `signAuthEntry` options on `ClientOptions` and `MethodOptions`, and the\n * per-call overrides on `AssembledTransaction`'s `sign`, `signAndSend`, and\n * `signAuthEntries`.\n */\nexport interface Signer {\n  /** The address this signer signs as: `G…` for accounts, `C…` for contracts. */\n  readonly address: string;\n  /** Signs a transaction envelope. Matches `signTransaction` from Freighter. */\n  signTransaction: SignTransaction;\n  /** Signs an auth entry preimage. Matches `signAuthEntry` from Freighter. */\n  signAuthEntry?: SignAuthEntry;\n}\n\n/**\n * A {@link Signer} backed by a local {@link Keypair}.\n *\n * Suitable for Node applications, scripts, and tests — anywhere the secret key\n * lives in the same process. For browser applications, use the SEP-43 wallet's\n * own `signTransaction`, or wrap it in an object satisfying {@link Signer}.\n *\n * @example\n * ```ts\n * import { Keypair } from \"@stellar/stellar-sdk\";\n * import { Client, KeypairSigner } from \"@stellar/stellar-sdk/contract\";\n *\n * const keypair = Keypair.fromSecret(secret);\n * const client = await Client.from({\n *   contractId,\n *   networkPassphrase,\n *   rpcUrl,\n *   publicKey: keypair.publicKey(),\n *   signTransaction: new KeypairSigner(keypair, networkPassphrase),\n * });\n * ```\n */\nexport class KeypairSigner implements Signer {\n  /**\n   * The keypair's Ed25519 account address (`G…`), always `keypair.publicKey()`.\n   */\n  readonly address: string;\n\n  /**\n   * @param keypair - the {@link Keypair} to sign with. Signing throws\n   *    `cannot sign: no secret key available` if it holds only a public key.\n   * @param networkPassphrase - passphrase of the network to sign for, used\n   *    whenever the caller does not pass one at signing time\n   */\n  constructor(\n    private readonly keypair: Keypair,\n    private readonly networkPassphrase: string,\n  ) {\n    this.address = keypair.publicKey();\n  }\n\n  /* Arrow instance properties rather than prototype methods because\n     `basicNodeSigner` destructures them into a plain object, which would lose\n     `this` on a prototype method. (The normalizers below tolerate either, since\n     they bind what they extract.)\n\n     They stay `async` despite having nothing to await (hence the rule\n     suppressions): that way a synchronous failure — malformed XDR, or a keypair\n     holding no secret key — rejects the returned promise instead of throwing,\n     preserving the behavior `basicNodeSigner` had before it delegated here. */\n\n  // eslint-disable-next-line @typescript-eslint/require-await\n  signTransaction: SignTransaction = async (xdr, opts) => {\n    const t = TransactionBuilder.fromXDR(\n      xdr,\n      opts?.networkPassphrase || this.networkPassphrase,\n    );\n\n    t.sign(this.keypair);\n\n    return {\n      signedTxXdr: t.toXDR(),\n      signerAddress: this.address,\n    };\n  };\n\n  // eslint-disable-next-line @typescript-eslint/require-await\n  signAuthEntry: SignAuthEntry = async (authEntry) => {\n    const signedAuthEntry = this.keypair\n      .sign(hash(Buffer.from(authEntry, \"base64\")))\n      .toString(\"base64\");\n\n    return {\n      signedAuthEntry,\n      signerAddress: this.address,\n    };\n  };\n}\n\n/**\n * Anything accepted where a `signTransaction` callback is expected: the raw\n * SEP-43 callback, a {@link Signer}, or a {@link Keypair}.\n */\nexport type SignTransactionLike = SignTransaction | Signer | Keypair;\n\n/**\n * Anything accepted where a `signAuthEntry` callback is expected: the raw\n * SEP-43 callback, a {@link Signer}, or a {@link Keypair}.\n */\nexport type SignAuthEntryLike = SignAuthEntry | Signer | Keypair;\n\n/**\n * Recognizes a {@link Keypair} by the three members {@link KeypairSigner} calls:\n * `publicKey` for the address, `sign` for auth entries, and `signDecorated`,\n * which `Transaction.sign` reaches for when signing an envelope. All three are\n * required, so a partial object is refused here rather than yielding a callback\n * that throws once it is actually used.\n *\n * Structural rather than `instanceof` on purpose: this package ships a CJS and\n * an ESM build whose `Keypair` classes are distinct objects, so a keypair made\n * through one entry point fails `instanceof` against the other despite working\n * perfectly. Duplicate copies of the SDK in one dependency tree do the same.\n *\n * Only ever reached after a `Signer` has been ruled out, so an object carrying\n * `signTransaction` can never be misrouted here.\n */\nfunction isKeypairLike(value: object): value is Keypair {\n  return (\n    \"publicKey\" in value &&\n    typeof value.publicKey === \"function\" &&\n    \"sign\" in value &&\n    typeof value.sign === \"function\" &&\n    \"signDecorated\" in value &&\n    typeof value.signDecorated === \"function\"\n  );\n}\n\n/** @internal */\nexport function signerAddress(\n  value: SignAuthEntryLike | undefined,\n): string | undefined {\n  if (value == null || typeof value !== \"object\") return undefined;\n  if (\"signTransaction\" in value && typeof value.address === \"string\") {\n    return value.address;\n  }\n  return isKeypairLike(value) ? value.publicKey() : undefined;\n}\n\n/**\n * Reduces the accepted signing shapes down to a plain callback.\n *\n * Anything that carries no usable callback yields `undefined` — including an\n * absent value, or an object that does not match any accepted shape — so the\n * caller decides how to report a missing signer. This is deliberately lenient:\n * callers reaching the SDK from plain JavaScript are not held to the types, and\n * a clear `NoSigner` beats a `TypeError` from deep inside a normalizer.\n *\n * Internal: called at the entry points that read a caller-supplied signer, so\n * the rest of the code only ever deals with a `SignTransaction`.\n */\nexport function toSignTransaction(\n  value: SignTransactionLike | undefined,\n  networkPassphrase: string,\n): SignTransaction | undefined {\n  // `== null` so an explicit `null` from a JS caller behaves like `undefined`.\n  if (value == null) return undefined;\n\n  if (typeof value === \"function\") return value;\n\n  // Guards the `in` checks below, which throw on primitives.\n  if (typeof value !== \"object\") return undefined;\n\n  // `signTransaction` is a `Signer`'s required member, so it identifies one.\n  // Bound because a `Signer` may implement it as a prototype method that relies\n  // on `this`; a bare reference would lose its receiver. The `typeof` check is\n  // for untyped callers: a present-but-non-function member has no `bind`.\n  if (\"signTransaction\" in value) {\n    const fn = value.signTransaction;\n    return typeof fn === \"function\" ? fn.bind(value) : undefined;\n  }\n\n  if (isKeypairLike(value)) {\n    return new KeypairSigner(value, networkPassphrase).signTransaction;\n  }\n\n  return undefined;\n}\n\n/**\n * Reduces the accepted signing shapes down to a plain callback.\n *\n * A {@link Signer} whose optional `signAuthEntry` is absent yields `undefined`,\n * so the caller reports it the same way it reports a missing option.\n *\n * Internal: see {@link toSignTransaction}.\n */\nexport function toSignAuthEntry(\n  value: SignAuthEntryLike | undefined,\n  networkPassphrase: string,\n): SignAuthEntry | undefined {\n  if (value == null) return undefined;\n\n  if (typeof value === \"function\") return value;\n\n  if (typeof value !== \"object\") return undefined;\n\n  // Identified and bound as in `toSignTransaction`. The `typeof` check also\n  // covers the ordinary case of a `Signer` that omits the optional\n  // `signAuthEntry`, which is reported as `undefined`.\n  if (\"signTransaction\" in value) {\n    const fn = value.signAuthEntry;\n    return typeof fn === \"function\" ? fn.bind(value) : undefined;\n  }\n\n  if (isKeypairLike(value)) {\n    return new KeypairSigner(value, networkPassphrase).signAuthEntry;\n  }\n\n  return undefined;\n}\n"],"names":[],"mappings":";;;;AAyDO,MAAM,aAAA,CAAgC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY3C,WAAA,CACmB,SACA,iBAAA,EACjB;AAFiB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,iBAAA,GAAA,iBAAA;AAEjB,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,SAAA,EAAU;AAAA,EACnC;AAAA,EAJmB,OAAA;AAAA,EACA,iBAAA;AAAA;AAAA;AAAA;AAAA,EAVV,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BT,eAAA,GAAmC,OAAO,GAAA,EAAK,IAAA,KAAS;AACtD,IAAA,MAAM,IAAI,kBAAA,CAAmB,OAAA;AAAA,MAC3B,GAAA;AAAA,MACA,IAAA,EAAM,qBAAqB,IAAA,CAAK;AAAA,KAClC;AAEA,IAAA,CAAA,CAAE,IAAA,CAAK,KAAK,OAAO,CAAA;AAEnB,IAAA,OAAO;AAAA,MACL,WAAA,EAAa,EAAE,KAAA,EAAM;AAAA,MACrB,eAAe,IAAA,CAAK;AAAA,KACtB;AAAA,EACF,CAAA;AAAA;AAAA,EAGA,aAAA,GAA+B,OAAO,SAAA,KAAc;AAClD,IAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,OAAA,CAC1B,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,SAAA,EAAW,QAAQ,CAAC,CAAC,CAAA,CAC3C,SAAS,QAAQ,CAAA;AAEpB,IAAA,OAAO;AAAA,MACL,eAAA;AAAA,MACA,eAAe,IAAA,CAAK;AAAA,KACtB;AAAA,EACF,CAAA;AACF;AA6BA,SAAS,cAAc,KAAA,EAAiC;AACtD,EAAA,OACE,eAAe,KAAA,IACf,OAAO,KAAA,CAAM,SAAA,KAAc,cAC3B,MAAA,IAAU,KAAA,IACV,OAAO,KAAA,CAAM,SAAS,UAAA,IACtB,eAAA,IAAmB,KAAA,IACnB,OAAO,MAAM,aAAA,KAAkB,UAAA;AAEnC;AAGO,SAAS,cACd,KAAA,EACoB;AACpB,EAAA,IAAI,KAAA,IAAS,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,MAAA;AACvD,EAAA,IAAI,iBAAA,IAAqB,KAAA,IAAS,OAAO,KAAA,CAAM,YAAY,QAAA,EAAU;AACnE,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AACA,EAAA,OAAO,aAAA,CAAc,KAAK,CAAA,GAAI,KAAA,CAAM,WAAU,GAAI,MAAA;AACpD;AAcO,SAAS,iBAAA,CACd,OACA,iBAAA,EAC6B;AAE7B,EAAA,IAAI,KAAA,IAAS,MAAM,OAAO,MAAA;AAE1B,EAAA,IAAI,OAAO,KAAA,KAAU,UAAA,EAAY,OAAO,KAAA;AAGxC,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AAMtC,EAAA,IAAI,qBAAqB,KAAA,EAAO;AAC9B,IAAA,MAAM,KAAK,KAAA,CAAM,eAAA;AACjB,IAAA,OAAO,OAAO,EAAA,KAAO,UAAA,GAAa,EAAA,CAAG,IAAA,CAAK,KAAK,CAAA,GAAI,MAAA;AAAA,EACrD;AAEA,EAAA,IAAI,aAAA,CAAc,KAAK,CAAA,EAAG;AACxB,IAAA,OAAO,IAAI,aAAA,CAAc,KAAA,EAAO,iBAAiB,CAAA,CAAE,eAAA;AAAA,EACrD;AAEA,EAAA,OAAO,MAAA;AACT;AAUO,SAAS,eAAA,CACd,OACA,iBAAA,EAC2B;AAC3B,EAAA,IAAI,KAAA,IAAS,MAAM,OAAO,MAAA;AAE1B,EAAA,IAAI,OAAO,KAAA,KAAU,UAAA,EAAY,OAAO,KAAA;AAExC,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AAKtC,EAAA,IAAI,qBAAqB,KAAA,EAAO;AAC9B,IAAA,MAAM,KAAK,KAAA,CAAM,aAAA;AACjB,IAAA,OAAO,OAAO,EAAA,KAAO,UAAA,GAAa,EAAA,CAAG,IAAA,CAAK,KAAK,CAAA,GAAI,MAAA;AAAA,EACrD;AAEA,EAAA,IAAI,aAAA,CAAc,KAAK,CAAA,EAAG;AACxB,IAAA,OAAO,IAAI,aAAA,CAAc,KAAA,EAAO,iBAAiB,CAAA,CAAE,aAAA;AAAA,EACrD;AAEA,EAAA,OAAO,MAAA;AACT;;;;"}