@sovereign-sdk/web3 0.10.0 → 0.11.0

package/dist/index.d.mts

@@ -159,6 +159,13 @@ type RollupConfig<C extends RollupContext> = {
      * Arbitrary context that is associated with the rollup.
      */
     context: C;
+    /**
+     * The endpoint path for submitting transactions.
+     * Defaults to "/sequencer/txs", the standard Sovereign SDK endpoint.
+     * Can be overridden if your rollup is configured to expose non-standard endpoints in
+     * order to support multiple different transaction encoding or authentication schemes.
+     */
+    txSubmissionEndpoint: string;
 };
 /**
  * The result of signing and submitting a transaction.
@@ -212,12 +219,16 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
     /**
      * Retrieve dedup information about the provided address.
      *
-     * @param address - The public key to dedup.
+     * @param publicKey - The public key to dedup.
+     * TODO: How to add param for generation explicitly
      */
-    dedup(address: Uint8Array): Promise<S["Dedup"]>;
+    dedup(publicKey: Uint8Array): Promise<S["Dedup"]>;
     /**
      * Submits a transaction to the rollup.
      *
+     * The endpoint used for submission can be overridden via the options.path parameter.
+     * If not specified, the rollup's configured txSubmissionEndpoint will be used.
+     *
      * @param transaction - The transaction to submit.
      * @param {SovereignClient.RequestOptions} options - The options for the request.
      */
@@ -229,6 +240,7 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
      * @param unsignedTx - The unsigned transaction to sign and submit.
      * @param {SignerParams} params - The params for signing and submitting the transaction.
      * @param {SovereignClient.RequestOptions} options - The options for the request.
+     * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.
      */
     signAndSubmitTransaction(unsignedTx: S["UnsignedTransaction"], { signer }: SignerParams, options?: SovereignClient__default.RequestOptions): Promise<TransactionResult<S["Transaction"]>>;
     /**
@@ -240,6 +252,28 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
      * @param {SovereignClient.RequestOptions} options - The options for the request.
      */
     call(runtimeCall: S["RuntimeCall"], { signer, overrides }: CallParams<S>, options?: SovereignClient__default.RequestOptions): Promise<TransactionResult<S["Transaction"]>>;
+    /**
+     * Prepares a runtime call by creating and signing a transaction without submitting it.
+     * This is useful for scenarios where you need the signed transaction for later submission
+     * or for analysis purposes.
+     *
+     * @param runtimeCall - The runtime message to prepare.
+     * @param params - The parameters for preparing the call.
+     * @param params.signer - The signer to use for signing the transaction.
+     * @param params.overrides - Optional overrides for the unsigned transaction.
+     * @returns A promise that resolves to the signed transaction.
+     */
+    prepareCall(runtimeCall: S["RuntimeCall"], { signer, overrides }: CallParams<S>): Promise<S["Transaction"]>;
+    /**
+     * Signs an unsigned transaction using the provided signer.
+     * Creates a signature by combining the serialized unsigned transaction with the chain hash,
+     * then constructs a fully signed transaction.
+     *
+     * @param unsignedTx - The unsigned transaction to sign.
+     * @param signer - The signer to use for signing the transaction.
+     * @returns A promise that resolves to the signed transaction.
+     */
+    signTransaction(unsignedTx: S["UnsignedTransaction"], signer: Signer): Promise<S["Transaction"]>;
     /**
      * Create a subscription to events emitted over websockets by the rollup.
      */
@@ -300,17 +334,11 @@ type UnsignedTransaction<RuntimeCall> = {
     details: TxDetails;
 };
 type TransactionV0<RuntimeCall> = {
-    pub_key: {
-        pub_key: Uint8Array;
-    };
-    signature: {
-        msg_sig: Uint8Array;
-    };
+    pub_key: HexString;
+    signature: HexString;
 } & UnsignedTransaction<RuntimeCall>;
 type Transaction<RuntimeCall> = {
-    versioned_tx: {
-        V0: TransactionV0<RuntimeCall>;
-    };
+    V0: TransactionV0<RuntimeCall>;
 };
 type Dedup = {
     nonce: number;
@@ -328,14 +356,7 @@ declare function standardTypeBuilder<S extends StandardRollupSpec<unknown>>(): T
 /**
  * The parameters for simulating a runtime call transaction.
  */
-type SimulateParams = {
-    /**
-     * The transaction details to use for the simulation.
-     */
-    txDetails: TxDetails;
-    /** The generation of the transaction for uniquness purposes. */
-    generation?: number;
-} & SignerParams;
+type SimulateParams = Omit<SovereignClient__default.RollupSimulateParams, "call" | "sender"> & SignerParams;
 declare class StandardRollup<RuntimeCall> extends Rollup<StandardRollupSpec<RuntimeCall>, StandardRollupContext> {
     /**
      * Simulates a runtime call transaction.
@@ -344,7 +365,7 @@ declare class StandardRollup<RuntimeCall> extends Rollup<StandardRollupSpec<Runt
      *
      * @param runtimeMessage - The runtime message to call.
      */
-    simulate(runtimeMessage: StandardRollupSpec<RuntimeCall>["RuntimeCall"], { signer, txDetails, generation: overrideGeneration }: SimulateParams): Promise<SovereignClient__default.Rollup.SimulateExecutionResponse>;
+    simulate(runtimeMessage: StandardRollupSpec<RuntimeCall>["RuntimeCall"], { signer }: SimulateParams): Promise<SovereignClient__default.Rollup.RollupSimulateResponse>;
 }
 declare const DEFAULT_TX_DETAILS: Omit<TxDetails, "chain_id">;
 declare function createStandardRollup<RuntimeCall, C extends StandardRollupContext = StandardRollupContext>(rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>, typeBuilderOverrides?: Partial<TypeBuilder<StandardRollupSpec<RuntimeCall>, C>>): Promise<StandardRollup<RuntimeCall>>;

package/dist/index.d.ts

@@ -159,6 +159,13 @@ type RollupConfig<C extends RollupContext> = {
      * Arbitrary context that is associated with the rollup.
      */
     context: C;
+    /**
+     * The endpoint path for submitting transactions.
+     * Defaults to "/sequencer/txs", the standard Sovereign SDK endpoint.
+     * Can be overridden if your rollup is configured to expose non-standard endpoints in
+     * order to support multiple different transaction encoding or authentication schemes.
+     */
+    txSubmissionEndpoint: string;
 };
 /**
  * The result of signing and submitting a transaction.
@@ -212,12 +219,16 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
     /**
      * Retrieve dedup information about the provided address.
      *
-     * @param address - The public key to dedup.
+     * @param publicKey - The public key to dedup.
+     * TODO: How to add param for generation explicitly
      */
-    dedup(address: Uint8Array): Promise<S["Dedup"]>;
+    dedup(publicKey: Uint8Array): Promise<S["Dedup"]>;
     /**
      * Submits a transaction to the rollup.
      *
+     * The endpoint used for submission can be overridden via the options.path parameter.
+     * If not specified, the rollup's configured txSubmissionEndpoint will be used.
+     *
      * @param transaction - The transaction to submit.
      * @param {SovereignClient.RequestOptions} options - The options for the request.
      */
@@ -229,6 +240,7 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
      * @param unsignedTx - The unsigned transaction to sign and submit.
      * @param {SignerParams} params - The params for signing and submitting the transaction.
      * @param {SovereignClient.RequestOptions} options - The options for the request.
+     * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.
      */
     signAndSubmitTransaction(unsignedTx: S["UnsignedTransaction"], { signer }: SignerParams, options?: SovereignClient__default.RequestOptions): Promise<TransactionResult<S["Transaction"]>>;
     /**
@@ -240,6 +252,28 @@ declare class Rollup<S extends BaseTypeSpec, C extends RollupContext> {
      * @param {SovereignClient.RequestOptions} options - The options for the request.
      */
     call(runtimeCall: S["RuntimeCall"], { signer, overrides }: CallParams<S>, options?: SovereignClient__default.RequestOptions): Promise<TransactionResult<S["Transaction"]>>;
+    /**
+     * Prepares a runtime call by creating and signing a transaction without submitting it.
+     * This is useful for scenarios where you need the signed transaction for later submission
+     * or for analysis purposes.
+     *
+     * @param runtimeCall - The runtime message to prepare.
+     * @param params - The parameters for preparing the call.
+     * @param params.signer - The signer to use for signing the transaction.
+     * @param params.overrides - Optional overrides for the unsigned transaction.
+     * @returns A promise that resolves to the signed transaction.
+     */
+    prepareCall(runtimeCall: S["RuntimeCall"], { signer, overrides }: CallParams<S>): Promise<S["Transaction"]>;
+    /**
+     * Signs an unsigned transaction using the provided signer.
+     * Creates a signature by combining the serialized unsigned transaction with the chain hash,
+     * then constructs a fully signed transaction.
+     *
+     * @param unsignedTx - The unsigned transaction to sign.
+     * @param signer - The signer to use for signing the transaction.
+     * @returns A promise that resolves to the signed transaction.
+     */
+    signTransaction(unsignedTx: S["UnsignedTransaction"], signer: Signer): Promise<S["Transaction"]>;
     /**
      * Create a subscription to events emitted over websockets by the rollup.
      */
@@ -300,17 +334,11 @@ type UnsignedTransaction<RuntimeCall> = {
     details: TxDetails;
 };
 type TransactionV0<RuntimeCall> = {
-    pub_key: {
-        pub_key: Uint8Array;
-    };
-    signature: {
-        msg_sig: Uint8Array;
-    };
+    pub_key: HexString;
+    signature: HexString;
 } & UnsignedTransaction<RuntimeCall>;
 type Transaction<RuntimeCall> = {
-    versioned_tx: {
-        V0: TransactionV0<RuntimeCall>;
-    };
+    V0: TransactionV0<RuntimeCall>;
 };
 type Dedup = {
     nonce: number;
@@ -328,14 +356,7 @@ declare function standardTypeBuilder<S extends StandardRollupSpec<unknown>>(): T
 /**
  * The parameters for simulating a runtime call transaction.
  */
-type SimulateParams = {
-    /**
-     * The transaction details to use for the simulation.
-     */
-    txDetails: TxDetails;
-    /** The generation of the transaction for uniquness purposes. */
-    generation?: number;
-} & SignerParams;
+type SimulateParams = Omit<SovereignClient__default.RollupSimulateParams, "call" | "sender"> & SignerParams;
 declare class StandardRollup<RuntimeCall> extends Rollup<StandardRollupSpec<RuntimeCall>, StandardRollupContext> {
     /**
      * Simulates a runtime call transaction.
@@ -344,7 +365,7 @@ declare class StandardRollup<RuntimeCall> extends Rollup<StandardRollupSpec<Runt
      *
      * @param runtimeMessage - The runtime message to call.
      */
-    simulate(runtimeMessage: StandardRollupSpec<RuntimeCall>["RuntimeCall"], { signer, txDetails, generation: overrideGeneration }: SimulateParams): Promise<SovereignClient__default.Rollup.SimulateExecutionResponse>;
+    simulate(runtimeMessage: StandardRollupSpec<RuntimeCall>["RuntimeCall"], { signer }: SimulateParams): Promise<SovereignClient__default.Rollup.RollupSimulateResponse>;
 }
 declare const DEFAULT_TX_DETAILS: Omit<TxDetails, "chain_id">;
 declare function createStandardRollup<RuntimeCall, C extends StandardRollupContext = StandardRollupContext>(rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>, typeBuilderOverrides?: Partial<TypeBuilder<StandardRollupSpec<RuntimeCall>, C>>): Promise<StandardRollup<RuntimeCall>>;

package/dist/index.js

@@ -217,17 +217,22 @@ var Rollup = class {
   /**
    * Retrieve dedup information about the provided address.
    *
-   * @param address - The public key to dedup.
+   * @param publicKey - The public key to dedup.
+   * TODO: How to add param for generation explicitly
    */
-  dedup(address) {
+  dedup(publicKey) {
     return __async(this, null, function* () {
-      const response = yield this.rollup.addresses.dedup((0, import_utils2.bytesToHex)(address));
+      const credentialId = (0, import_utils2.bytesToHex)(publicKey);
+      const response = yield this.rollup.addresses.dedup(credentialId);
       return response;
     });
   }
   /**
    * Submits a transaction to the rollup.
    *
+   * The endpoint used for submission can be overridden via the options.path parameter.
+   * If not specified, the rollup's configured txSubmissionEndpoint will be used.
+   *
    * @param transaction - The transaction to submit.
    * @param {SovereignClient.RequestOptions} options - The options for the request.
    */
@@ -235,10 +240,14 @@ var Rollup = class {
     return __async(this, null, function* () {
       const serializer = yield this.serializer();
       const serializedTx = serializer.serializeTx(transaction);
-      return this.sequencer.txs.create({ body: import_js_base64.Base64.fromUint8Array(serializedTx) }, options).catch((e) => __async(this, null, function* () {
+      const _a = options || {}, { body: _, query: __, path } = _a, requestOptions = __objRest(_a, ["body", "query", "path"]);
+      const txSubmissionEndpoint = path || this._config.txSubmissionEndpoint;
+      return this.http.post(txSubmissionEndpoint, __spreadValues({
+        body: { body: import_js_base64.Base64.fromUint8Array(serializedTx) }
+      }, requestOptions)).catch((e) => __async(this, null, function* () {
         if (isVersionMismatchError(e)) {
           const oldVersion = (0, import_utils2.bytesToHex)(yield this.chainHash());
-          const { schema, chain_hash: newVersion } = yield this.rollup.schema.retrieve();
+          const { schema, chain_hash: newVersion } = yield this.rollup.schema();
           this._chainHash = (0, import_utils2.hexToBytes)(newVersion);
           this._serializer = this._config.getSerializer(schema);
           if (oldVersion !== newVersion) {
@@ -260,23 +269,11 @@ var Rollup = class {
    * @param unsignedTx - The unsigned transaction to sign and submit.
    * @param {SignerParams} params - The params for signing and submitting the transaction.
    * @param {SovereignClient.RequestOptions} options - The options for the request.
+   * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.
    */
   signAndSubmitTransaction(_0, _1, _2) {
     return __async(this, arguments, function* (unsignedTx, { signer }, options) {
-      const serializer = yield this.serializer();
-      const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);
-      const chainHash = yield this.chainHash();
-      const signature = yield signer.sign(
-        new Uint8Array([...serializedUnsignedTx, ...chainHash])
-      );
-      const publicKey = yield signer.publicKey();
-      const context = {
-        unsignedTx,
-        sender: publicKey,
-        signature,
-        rollup: this
-      };
-      const tx = yield this._typeBuilder.transaction(context);
+      const tx = yield this.signTransaction(unsignedTx, signer);
       const result = yield this.submitTransaction(tx, options);
       return { transaction: tx, response: result };
     });
@@ -306,6 +303,55 @@ var Rollup = class {
       );
     });
   }
+  /**
+   * Prepares a runtime call by creating and signing a transaction without submitting it.
+   * This is useful for scenarios where you need the signed transaction for later submission
+   * or for analysis purposes.
+   *
+   * @param runtimeCall - The runtime message to prepare.
+   * @param params - The parameters for preparing the call.
+   * @param params.signer - The signer to use for signing the transaction.
+   * @param params.overrides - Optional overrides for the unsigned transaction.
+   * @returns A promise that resolves to the signed transaction.
+   */
+  prepareCall(_0, _1) {
+    return __async(this, arguments, function* (runtimeCall, { signer, overrides }) {
+      const context = {
+        runtimeCall,
+        rollup: this,
+        overrides: overrides != null ? overrides : {}
+      };
+      const unsignedTx = yield this._typeBuilder.unsignedTransaction(context);
+      return this.signTransaction(unsignedTx, signer);
+    });
+  }
+  /**
+   * Signs an unsigned transaction using the provided signer.
+   * Creates a signature by combining the serialized unsigned transaction with the chain hash,
+   * then constructs a fully signed transaction.
+   *
+   * @param unsignedTx - The unsigned transaction to sign.
+   * @param signer - The signer to use for signing the transaction.
+   * @returns A promise that resolves to the signed transaction.
+   */
+  signTransaction(unsignedTx, signer) {
+    return __async(this, null, function* () {
+      const serializer = yield this.serializer();
+      const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);
+      const chainHash = yield this.chainHash();
+      const signature = yield signer.sign(
+        new Uint8Array([...serializedUnsignedTx, ...chainHash])
+      );
+      const publicKey = yield signer.publicKey();
+      const context = {
+        unsignedTx,
+        sender: publicKey,
+        signature,
+        rollup: this
+      };
+      return this._typeBuilder.transaction(context);
+    });
+  }
   /**
    * Create a subscription to events emitted over websockets by the rollup.
    */
@@ -361,7 +407,7 @@ var Rollup = class {
   serializer() {
     return __async(this, null, function* () {
       if (this._serializer) return this._serializer;
-      const { schema } = yield this.rollup.schema.retrieve();
+      const { schema } = yield this.rollup.schema();
       this._serializer = this._config.getSerializer(schema);
       return this._serializer;
     });
@@ -375,7 +421,7 @@ var Rollup = class {
   chainHash() {
     return __async(this, null, function* () {
       if (this._chainHash) return this._chainHash;
-      const { chain_hash } = yield this.rollup.schema.retrieve();
+      const { chain_hash } = yield this.rollup.schema();
       this._chainHash = (0, import_utils2.hexToBytes)(chain_hash);
       return this._chainHash;
     });
@@ -426,16 +472,10 @@ function standardTypeBuilder() {
         unsignedTx
       }) {
         return {
-          versioned_tx: {
-            V0: __spreadValues({
-              pub_key: {
-                pub_key: sender
-              },
-              signature: {
-                msg_sig: signature
-              }
-            }, unsignedTx)
-          }
+          V0: __spreadValues({
+            pub_key: (0, import_utils3.bytesToHex)(sender),
+            signature: (0, import_utils3.bytesToHex)(signature)
+          }, unsignedTx)
         };
       });
     }
@@ -450,29 +490,11 @@ var StandardRollup = class extends Rollup {
    * @param runtimeMessage - The runtime message to call.
    */
   simulate(_0, _1) {
-    return __async(this, arguments, function* (runtimeMessage, { signer, txDetails, generation: overrideGeneration }) {
-      const serializer = yield this.serializer();
-      const runtimeCall = serializer.serializeRuntimeCall(runtimeMessage);
+    return __async(this, arguments, function* (runtimeMessage, { signer }) {
       const publicKey = yield signer.publicKey();
-      const uniqueness = yield useOrFetchUniqueness({
-        rollup: this,
-        overrides: {
-          uniqueness: overrideGeneration ? { generation: overrideGeneration } : void 0
-        }
-      });
-      const generation = "generation" in uniqueness ? uniqueness.generation : uniqueness.nonce;
-      const response = yield this.rollup.simulate({
-        body: {
-          details: __spreadProps(__spreadValues({}, txDetails), {
-            // simulate needs this field as `undefined` currently
-            gas_limit: txDetails.gas_limit || void 0
-          }),
-          encoded_call_message: (0, import_utils3.bytesToHex)(runtimeCall),
-          generation,
-          sender_pub_key: (0, import_utils3.bytesToHex)(publicKey)
-        }
-      });
-      return response;
+      const sender = (0, import_utils3.bytesToHex)(publicKey);
+      const call = runtimeMessage;
+      return this.rollup.simulate({ sender, call });
     });
   }
 };
@@ -485,7 +507,7 @@ function buildContext(client, context) {
   return __async(this, null, function* () {
     const defaultTxDetails = __spreadValues(__spreadValues({}, DEFAULT_TX_DETAILS), context == null ? void 0 : context.defaultTxDetails);
     if (!defaultTxDetails.chain_id) {
-      const { chain_id } = yield client.rollup.constants.retrieve();
+      const { chain_id } = yield client.rollup.constants();
       defaultTxDetails.chain_id = chain_id;
     }
     return {
@@ -495,13 +517,19 @@ function buildContext(client, context) {
 }
 function createStandardRollup(rollupConfig, typeBuilderOverrides) {
   return __async(this, null, function* () {
-    var _a, _b;
+    var _a, _b, _c;
     const config = rollupConfig != null ? rollupConfig : {};
     const client = (_a = config.client) != null ? _a : new import_client2.default({ baseURL: config.url });
     const getSerializer = (_b = config.getSerializer) != null ? _b : (schema) => new import_serializers.JsSerializer(schema);
     const context = yield buildContext(client, config.context);
+    const txSubmissionEndpoint = (_c = config.txSubmissionEndpoint) != null ? _c : "/sequencer/txs";
     return new StandardRollup(
-      __spreadProps(__spreadValues({}, config), { client, getSerializer, context }),
+      __spreadProps(__spreadValues({}, config), {
+        client,
+        getSerializer,
+        context,
+        txSubmissionEndpoint
+      }),
       __spreadValues(__spreadValues({}, standardTypeBuilder()), typeBuilderOverrides)
     );
   });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/addresses.ts","../src/rollup/rollup.ts","../src/errors.ts","../src/subscriptions.ts","../src/rollup/standard-rollup.ts"],"sourcesContent":["export * from \"./addresses\";\nexport * from \"./rollup\";\nexport * from \"./errors\";\nexport * from \"./type-spec\";\nexport { type EventPayload, Subscription } from \"./subscriptions\";\nexport * as SovereignClient from \"@sovereign-sdk/client\";\n","import { type HexString, ensureBytes } from \"@sovereign-sdk/utils\";\nimport { bech32m } from \"bech32\";\n\n/**\n * Encodes a public key as a bech32m address with the given human-readable part (hrp).\n *\n * @param publicKey - The public key to encode, as a hex string or Uint8Array.\n * @param hrp - The human-readable part for the bech32m address (e.g., \"sov\").\n * @param concatPublicKey - Optional. If provided, only the first `concatPublicKey` bytes of the public key are used.\n * @returns The bech32m-encoded address as a string.\n * @throws {Error} If the public key is not a valid hex string or Uint8Array.\n */\nexport function addressFromPublicKey(\n  publicKey: HexString | Uint8Array,\n  hrp: string,\n  concatPublicKey = 28,\n): string {\n  let publicKeyBytes = ensureBytes(publicKey);\n\n  if (concatPublicKey !== publicKey.length) {\n    publicKeyBytes = publicKeyBytes.slice(0, concatPublicKey);\n  }\n\n  const words = bech32m.toWords(publicKeyBytes);\n  return bech32m.encode(hrp, words);\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport type { APIError } from \"@sovereign-sdk/client\";\nimport type { RollupSchema, Serializer } from \"@sovereign-sdk/serializers\";\nimport type { Signer } from \"@sovereign-sdk/signers\";\nimport { bytesToHex, hexToBytes } from \"@sovereign-sdk/utils\";\nimport { Base64 } from \"js-base64\";\nimport { VersionMismatchError } from \"../errors\";\nimport {\n  type Subscription,\n  type SubscriptionToCallbackMap,\n  createSubscription,\n} from \"../subscriptions\";\nimport type { BaseTypeSpec } from \"../type-spec\";\nimport type { DeepPartial } from \"../utils\";\n\nexport type UnsignedTransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  runtimeCall: S[\"RuntimeCall\"];\n  // Provides the ability to override the generation data instead of retrieving it automatically.\n  overrides: DeepPartial<S[\"UnsignedTransaction\"]>;\n  rollup: Rollup<S, C>;\n};\n\nexport type TransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  unsignedTx: S[\"UnsignedTransaction\"];\n  sender: Uint8Array;\n  signature: Uint8Array;\n  rollup: Rollup<S, C>;\n};\n\nexport type TypeBuilder<S extends BaseTypeSpec, C extends RollupContext> = {\n  unsignedTransaction: (\n    context: UnsignedTransactionContext<S, C>,\n  ) => Promise<S[\"UnsignedTransaction\"]>;\n\n  transaction: (context: TransactionContext<S, C>) => Promise<S[\"Transaction\"]>;\n};\n\n/**\n * Arbitrary context that is associated with the rollup.\n */\nexport type RollupContext = Record<string, unknown>;\n\n/**\n * The configuration for a rollup client.\n */\nexport type RollupConfig<C extends RollupContext> = {\n  /**\n   * The base URL of the rollup full node API.\n   */\n  url?: string;\n  /**\n   * The Sovereign SDK client to use for the rollup.\n   * If not provided, the default client will be used using {@link PartialRollupConfig.url}.\n   */\n  client: SovereignClient;\n  /**\n   * Creates the serializer instance to use for the rollup.\n   *\n   * This can be called more than once, for example if the chain hash changes (i.e a new rollup version)\n   * is detected then it will be called again with the new rollup schema.\n   */\n  getSerializer: (schema: RollupSchema) => Serializer;\n  /**\n   * Arbitrary context that is associated with the rollup.\n   */\n  context: C;\n};\n\n/**\n * The result of signing and submitting a transaction.\n *\n * @template Tx The type of the transaction\n */\nexport type TransactionResult<Tx> = {\n  /**\n   * The response from the sequencer.\n   */\n  response: SovereignClient.Sequencer.TxCreateResponse;\n  /**\n   * The transaction that was submitted.\n   */\n  transaction: Tx;\n};\n\n/**\n * The parameters for signing and submitting a transaction.\n */\nexport type SignerParams = {\n  /**\n   * The signer to use for signing the transaction.\n   */\n  signer: Signer;\n};\n\n/**\n * The parameters for calling executing a runtime call transaction.\n */\nexport type CallParams<S extends BaseTypeSpec> = {\n  overrides?: DeepPartial<S[\"UnsignedTransaction\"]>;\n} & SignerParams;\n\n/**\n * A generic rollup client.\n *\n * @template S - The type specification for the rollup.\n *               If not provided, the base type specification will be used which uses `any` for all types.\n * @template C - The context for the rollup.\n */\nexport class Rollup<S extends BaseTypeSpec, C extends RollupContext> {\n  private readonly _config: RollupConfig<C>;\n  private readonly _typeBuilder: TypeBuilder<S, C>;\n  private _chainHash?: Uint8Array;\n  private _serializer?: Serializer;\n\n  /**\n   * Creates a new rollup client.\n   *\n   * @param config - The configuration for the rollup client.\n   * @param typeBuilder - The type builder for the rollup.\n   */\n  constructor(config: RollupConfig<C>, typeBuilder: TypeBuilder<S, C>) {\n    this._config = config;\n    this._typeBuilder = typeBuilder;\n  }\n\n  /**\n   * Retrieve dedup information about the provided address.\n   *\n   * @param address - The public key to dedup.\n   */\n  async dedup(address: Uint8Array): Promise<S[\"Dedup\"]> {\n    const response = await this.rollup.addresses.dedup(bytesToHex(address));\n    return response as S[\"Dedup\"];\n  }\n\n  /**\n   * Submits a transaction to the rollup.\n   *\n   * @param transaction - The transaction to submit.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async submitTransaction(\n    transaction: S[\"Transaction\"],\n    options?: SovereignClient.RequestOptions,\n  ): Promise<SovereignClient.Sequencer.TxCreateResponse> {\n    const serializer = await this.serializer();\n    const serializedTx = serializer.serializeTx(transaction);\n\n    return this.sequencer.txs\n      .create({ body: Base64.fromUint8Array(serializedTx) }, options)\n      .catch(async (e) => {\n        if (isVersionMismatchError(e as APIError)) {\n          const oldVersion = bytesToHex(await this.chainHash());\n          const { schema, chain_hash: newVersion } =\n            await this.rollup.schema.retrieve();\n          this._chainHash = hexToBytes(newVersion);\n          this._serializer = this._config.getSerializer(schema);\n\n          if (oldVersion !== newVersion) {\n            throw new VersionMismatchError(\n              \"Schema version mismatch when submitting transaction\",\n              newVersion,\n              oldVersion,\n            );\n          }\n        }\n        throw e;\n      });\n  }\n\n  /**\n   * Signs and submits a transaction to the rollup.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign and submit.\n   * @param {SignerParams} params - The params for signing and submitting the transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async signAndSubmitTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    { signer }: SignerParams,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const serializer = await this.serializer();\n    const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);\n    const chainHash = await this.chainHash();\n    const signature = await signer.sign(\n      new Uint8Array([...serializedUnsignedTx, ...chainHash]),\n    );\n    const publicKey = await signer.publicKey();\n    const context = {\n      unsignedTx,\n      sender: publicKey,\n      signature,\n      rollup: this,\n    };\n    const tx = await this._typeBuilder.transaction(context);\n    const result = await this.submitTransaction(tx, options);\n\n    return { transaction: tx, response: result };\n  }\n\n  /**\n   * Performs a runtime call transaction.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param runtimeCall - The runtime message to call.\n   * @param {CallParams<S>} params - The params for submitting a runtime call transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async call(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n\n    return this.signAndSubmitTransaction(\n      unsignedTx,\n      {\n        signer,\n      },\n      options,\n    );\n  }\n\n  /**\n   * Create a subscription to events emitted over websockets by the rollup.\n   */\n  subscribe<T extends keyof SubscriptionToCallbackMap>(\n    type: T,\n    callback: SubscriptionToCallbackMap[T],\n  ): Subscription {\n    return createSubscription(type, callback, this.http);\n  }\n\n  /**\n   * Performs a healthcheck against the rollup to determine if it is currently healthy.\n   *\n   * @param timeout - Request timeout in milliseconds.\n   * @returns `true` if the rollup is considered healthy otherwise `false`.\n   */\n  async healthcheck(timeout = 5000): Promise<boolean> {\n    try {\n      await this.http.get(\"/healthcheck\", { timeout, maxRetries: 1 });\n      return true;\n    } catch (e) {\n      return !(e instanceof SovereignClient.APIConnectionError);\n    }\n  }\n\n  /**\n   * A ledger client that can be used to query the ledger.\n   */\n  get ledger(): SovereignClient.Ledger {\n    return this.http.ledger;\n  }\n\n  /**\n   * A sequencer client that can be used to submit transactions & batches to the rollup.\n   */\n  get sequencer(): SovereignClient.Sequencer {\n    return this.http.sequencer;\n  }\n\n  /**\n   * A rollup client that can be used to perform operations on the rollup.\n   */\n  get rollup(): SovereignClient.Rollup {\n    return this.http.rollup;\n  }\n\n  /**\n   * A client that can be used to perform HTTP requests to the Sovereign API.\n   * This can be used as an escape hatch to execute arbitrary requests to the Sovereign API\n   * if the operation is not supported by `ledger`, `sequencer`, or `rollup` clients.\n   */\n  get http(): SovereignClient {\n    return this._config.client;\n  }\n\n  /**\n   * The serializer for the rollup.\n   * Can be used to serialize transactions, runtime calls, etc.\n   */\n  async serializer(): Promise<Serializer> {\n    if (this._serializer) return this._serializer;\n    const { schema } = await this.rollup.schema.retrieve();\n    this._serializer = this._config.getSerializer(schema);\n    return this._serializer;\n  }\n\n  /**\n   * The context for the rollup.\n   */\n  get context(): C {\n    return this._config.context;\n  }\n\n  async chainHash(): Promise<Uint8Array> {\n    if (this._chainHash) return this._chainHash;\n    const { chain_hash } = await this.rollup.schema.retrieve();\n    this._chainHash = hexToBytes(chain_hash);\n    return this._chainHash;\n  }\n}\n\nfunction isVersionMismatchError(e: APIError): boolean {\n  if (\n    // biome-ignore lint/suspicious/noExplicitAny: yolo\n    (e.error as any)?.details?.error?.includes(\"Signature verification failed\")\n  ) {\n    return true;\n  }\n\n  return false;\n}\n","/**\n * Base error class for Sovereign SDK Web3.\n */\nexport class SovereignError extends Error {\n  constructor(message: string) {\n    super(message);\n\n    this.name = this.constructor.name;\n    this.stack = new Error().stack;\n  }\n}\n\nexport class InvalidRollupConfigError extends SovereignError {}\n\nexport class VersionMismatchError extends SovereignError {\n  public readonly newVersion: string;\n  public readonly currentVersion: string;\n  public readonly retryable: boolean;\n\n  constructor(message: string, newVersion: string, currentVersion: string) {\n    super(message);\n\n    this.newVersion = newVersion;\n    this.currentVersion = currentVersion;\n    this.retryable = newVersion !== currentVersion;\n  }\n}\n\nexport class SchemaError extends SovereignError {\n  public readonly schema: object;\n  public readonly reason: string;\n\n  constructor(message: string, reason: string, schema: object) {\n    super(`${message}: ${reason}`);\n\n    this.reason = reason;\n    this.schema = schema;\n  }\n}\n","import type SovereignSDK from \"@sovereign-sdk/client\";\nimport IsoWebSocket from \"isomorphic-ws\";\nimport { WebSocket } from \"partysocket\";\nimport { SovereignError } from \"./errors\";\n\ntype Url = string;\n\nexport function httpToWebSocket(url: string) {\n  return url.replace(/^http(s?):\\/\\//, (_, s) => `ws${s}://`);\n}\n\nexport type Subscription = {\n  /** Url providing the subscription. */\n  url: Url;\n  /** Unsubscribe this subscription. */\n  unsubscribe: () => void;\n};\n\ntype SubscriptionEntry = {\n  websocket: WebSocket;\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callbacks: Array<(...args: any[]) => void>;\n};\n\nexport const _subscriptions: Record<Url, SubscriptionEntry> = {};\n\n/** Subscribe to the provided websocket url & call the provided callback on messages received. */\nexport function subscribe(\n  url: Url,\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callback: (...args: any[]) => void,\n): Subscription {\n  const subscription = _subscriptions[url];\n\n  if (!subscription) {\n    const websocket = new WebSocket(url, [], { WebSocket: IsoWebSocket });\n    // bun compatibility: https://github.com/partykit/partykit/issues/774\n    websocket.binaryType = \"arraybuffer\";\n\n    _subscriptions[url] = {\n      websocket,\n      callbacks: [callback],\n    };\n\n    websocket.addEventListener(\"message\", (message) => {\n      const data = JSON.parse(message.data);\n      const callbacks = _subscriptions[url]?.callbacks;\n      if (callbacks) {\n        for (const cb of callbacks) {\n          cb(data);\n        }\n      }\n    });\n    websocket.addEventListener(\"error\", (e) =>\n      console.log(\"Websocket error\", e),\n    );\n  } else {\n    subscription.callbacks.push(callback);\n  }\n\n  const callbackIndex = _subscriptions[url]?.callbacks.length - 1;\n\n  return {\n    get url() {\n      return url;\n    },\n    unsubscribe() {\n      const subscription = _subscriptions[url];\n\n      if (!subscription) {\n        return;\n      }\n\n      subscription.callbacks.splice(callbackIndex, 1);\n\n      if (!subscription.callbacks.length) {\n        subscription.websocket.close();\n        delete _subscriptions[url];\n      }\n    },\n  };\n}\n\nexport type EventPayload = {\n  tx_hash: string;\n  type: \"event\";\n  number: number;\n  key: string;\n  value: Record<string, unknown>;\n  module: {\n    type: \"moduleRef\";\n    name: string;\n  };\n};\n\nexport interface SubscriptionToCallbackMap {\n  events: (event: EventPayload) => Promise<void>;\n}\n\nexport function createSubscription<T extends keyof SubscriptionToCallbackMap>(\n  subscription: T,\n  callback: SubscriptionToCallbackMap[T],\n  client: SovereignSDK,\n): Subscription {\n  switch (subscription) {\n    case \"events\": {\n      const url = client.buildURL(\"/sequencer/events/ws\", {});\n      return subscribe(\n        httpToWebSocket(url),\n        callback as SubscriptionToCallbackMap[\"events\"],\n      );\n    }\n    default:\n      throw new SovereignError(`Invalid subscription type '${subscription}'`);\n  }\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport { JsSerializer } from \"@sovereign-sdk/serializers\";\nimport { bytesToHex } from \"@sovereign-sdk/utils\";\nimport type { DeepPartial } from \"../utils\";\nimport {\n  Rollup,\n  type RollupConfig,\n  type SignerParams,\n  type TransactionContext,\n  type TypeBuilder,\n  type UnsignedTransactionContext,\n} from \"./rollup\";\n\nexport type TxDetails = {\n  max_priority_fee_bips: number;\n  max_fee: string;\n  gas_limit: number[] | null;\n  chain_id: number;\n};\n\nexport type Generation = { generation: number };\nexport type Nonce = { nonce: number };\nexport type Uniqueness = Nonce | Generation;\n\nexport type UnsignedTransaction<RuntimeCall> = {\n  runtime_call: RuntimeCall;\n  uniqueness: Uniqueness;\n  details: TxDetails;\n};\n\nexport type TransactionV0<RuntimeCall> = {\n  pub_key: { pub_key: Uint8Array };\n  signature: { msg_sig: Uint8Array };\n} & UnsignedTransaction<RuntimeCall>;\n\nexport type Transaction<RuntimeCall> = {\n  versioned_tx: { V0: TransactionV0<RuntimeCall> };\n};\n\nexport type Dedup = {\n  nonce: number;\n};\n\nexport type StandardRollupContext = {\n  defaultTxDetails: TxDetails;\n};\n\nexport type StandardRollupSpec<RuntimeCall> = {\n  UnsignedTransaction: UnsignedTransaction<RuntimeCall>;\n  Transaction: Transaction<RuntimeCall>;\n  RuntimeCall: RuntimeCall;\n  Dedup: Dedup;\n};\n\nconst useOrFetchUniqueness = async <S extends StandardRollupSpec<unknown>>({\n  overrides,\n}: Omit<\n  UnsignedTransactionContext<S, StandardRollupContext>,\n  \"runtimeCall\"\n>) => {\n  if (overrides?.uniqueness) {\n    return overrides.uniqueness;\n  }\n\n  return { generation: Date.now() };\n};\n\nexport function standardTypeBuilder<\n  S extends StandardRollupSpec<unknown>,\n>(): TypeBuilder<S, StandardRollupContext> {\n  return {\n    async unsignedTransaction(\n      context: UnsignedTransactionContext<S, StandardRollupContext>,\n    ) {\n      const { rollup, runtimeCall } = context;\n      const { uniqueness: _, ...overrides } = context.overrides;\n      const uniqueness = await useOrFetchUniqueness(context);\n      const details: TxDetails = {\n        ...rollup.context.defaultTxDetails,\n        ...overrides.details,\n      };\n\n      return {\n        runtime_call: runtimeCall,\n        uniqueness,\n        details,\n      } as S[\"UnsignedTransaction\"];\n    },\n    async transaction({\n      sender,\n      signature,\n      unsignedTx,\n    }: TransactionContext<S, StandardRollupContext>) {\n      return {\n        versioned_tx: {\n          V0: {\n            pub_key: {\n              pub_key: sender,\n            },\n            signature: {\n              msg_sig: signature,\n            },\n            ...unsignedTx,\n          },\n        },\n      };\n    },\n  };\n}\n\n/**\n * The parameters for simulating a runtime call transaction.\n */\nexport type SimulateParams = {\n  /**\n   * The transaction details to use for the simulation.\n   */\n  txDetails: TxDetails;\n\n  /** The generation of the transaction for uniquness purposes. */\n  generation?: number;\n} & SignerParams;\n\nexport class StandardRollup<RuntimeCall> extends Rollup<\n  StandardRollupSpec<RuntimeCall>,\n  StandardRollupContext\n> {\n  /**\n   * Simulates a runtime call transaction.\n   *\n   * This method can be useful to estimate the gas cost of a runtime call transaction.\n   *\n   * @param runtimeMessage - The runtime message to call.\n   */\n  async simulate(\n    runtimeMessage: StandardRollupSpec<RuntimeCall>[\"RuntimeCall\"],\n    { signer, txDetails, generation: overrideGeneration }: SimulateParams,\n  ): Promise<SovereignClient.Rollup.SimulateExecutionResponse> {\n    const serializer = await this.serializer();\n    const runtimeCall = serializer.serializeRuntimeCall(runtimeMessage);\n    const publicKey = await signer.publicKey();\n    const uniqueness = await useOrFetchUniqueness({\n      rollup: this,\n      overrides: {\n        uniqueness: overrideGeneration\n          ? { generation: overrideGeneration }\n          : undefined,\n      },\n    });\n    // Extract the generation number from the uniqueness object\n    const generation =\n      \"generation\" in uniqueness\n        ? (uniqueness as Generation).generation\n        : (uniqueness as Nonce).nonce; // Use nonce as fallback until simulate endpoint is updated.\n    const response = await this.rollup.simulate({\n      body: {\n        details: {\n          ...txDetails,\n          // simulate needs this field as `undefined` currently\n          gas_limit: txDetails.gas_limit || undefined,\n        },\n        encoded_call_message: bytesToHex(runtimeCall),\n        generation,\n        sender_pub_key: bytesToHex(publicKey),\n      },\n    });\n\n    return response;\n  }\n}\n\nexport const DEFAULT_TX_DETAILS: Omit<TxDetails, \"chain_id\"> = {\n  max_priority_fee_bips: 0,\n  max_fee: \"100000000\",\n  gas_limit: null,\n};\n\nasync function buildContext<C extends StandardRollupContext>(\n  client: SovereignClient,\n  context?: DeepPartial<C>,\n): Promise<C> {\n  const defaultTxDetails = {\n    ...DEFAULT_TX_DETAILS,\n    ...context?.defaultTxDetails,\n  };\n\n  if (!defaultTxDetails.chain_id) {\n    const { chain_id } = await client.rollup.constants.retrieve();\n\n    defaultTxDetails.chain_id = chain_id;\n  }\n\n  return {\n    defaultTxDetails,\n  } as C;\n}\n\nexport async function createStandardRollup<\n  RuntimeCall,\n  C extends StandardRollupContext = StandardRollupContext,\n>(\n  rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>,\n  typeBuilderOverrides?: Partial<\n    TypeBuilder<StandardRollupSpec<RuntimeCall>, C>\n  >,\n) {\n  const config = rollupConfig ?? {};\n  const client = config.client ?? new SovereignClient({ baseURL: config.url });\n  const getSerializer =\n    config.getSerializer ?? ((schema) => new JsSerializer(schema));\n  const context = await buildContext<C>(client, config.context);\n\n  return new StandardRollup<RuntimeCall>(\n    { ...config, client, getSerializer, context },\n    {\n      ...standardTypeBuilder(),\n      ...typeBuilderOverrides,\n    },\n  );\n}\n"],"mappings":"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","names":["SovereignClient","import_utils","IsoWebSocket","_a","subscription","SovereignClient","import_client","import_utils","_a","SovereignClient","SovereignClient"]}
+{"version":3,"sources":["../src/index.ts","../src/addresses.ts","../src/rollup/rollup.ts","../src/errors.ts","../src/subscriptions.ts","../src/rollup/standard-rollup.ts"],"sourcesContent":["export * from \"./addresses\";\nexport * from \"./rollup\";\nexport * from \"./errors\";\nexport * from \"./type-spec\";\nexport { type EventPayload, Subscription } from \"./subscriptions\";\nexport * as SovereignClient from \"@sovereign-sdk/client\";\n","import { type HexString, ensureBytes } from \"@sovereign-sdk/utils\";\nimport { bech32m } from \"bech32\";\n\n/**\n * Encodes a public key as a bech32m address with the given human-readable part (hrp).\n *\n * @param publicKey - The public key to encode, as a hex string or Uint8Array.\n * @param hrp - The human-readable part for the bech32m address (e.g., \"sov\").\n * @param concatPublicKey - Optional. If provided, only the first `concatPublicKey` bytes of the public key are used.\n * @returns The bech32m-encoded address as a string.\n * @throws {Error} If the public key is not a valid hex string or Uint8Array.\n */\nexport function addressFromPublicKey(\n  publicKey: HexString | Uint8Array,\n  hrp: string,\n  concatPublicKey = 28,\n): string {\n  let publicKeyBytes = ensureBytes(publicKey);\n\n  if (concatPublicKey !== publicKey.length) {\n    publicKeyBytes = publicKeyBytes.slice(0, concatPublicKey);\n  }\n\n  const words = bech32m.toWords(publicKeyBytes);\n  return bech32m.encode(hrp, words);\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport type { APIError } from \"@sovereign-sdk/client\";\nimport type { RollupSchema, Serializer } from \"@sovereign-sdk/serializers\";\nimport type { Signer } from \"@sovereign-sdk/signers\";\nimport { bytesToHex, hexToBytes } from \"@sovereign-sdk/utils\";\nimport { Base64 } from \"js-base64\";\nimport { VersionMismatchError } from \"../errors\";\nimport {\n  type Subscription,\n  type SubscriptionToCallbackMap,\n  createSubscription,\n} from \"../subscriptions\";\nimport type { BaseTypeSpec } from \"../type-spec\";\nimport type { DeepPartial } from \"../utils\";\n\nexport type UnsignedTransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  runtimeCall: S[\"RuntimeCall\"];\n  // Provides the ability to override the generation data instead of retrieving it automatically.\n  overrides: DeepPartial<S[\"UnsignedTransaction\"]>;\n  rollup: Rollup<S, C>;\n};\n\nexport type TransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  unsignedTx: S[\"UnsignedTransaction\"];\n  sender: Uint8Array;\n  signature: Uint8Array;\n  rollup: Rollup<S, C>;\n};\n\nexport type TypeBuilder<S extends BaseTypeSpec, C extends RollupContext> = {\n  unsignedTransaction: (\n    context: UnsignedTransactionContext<S, C>,\n  ) => Promise<S[\"UnsignedTransaction\"]>;\n\n  transaction: (context: TransactionContext<S, C>) => Promise<S[\"Transaction\"]>;\n};\n\n/**\n * Arbitrary context that is associated with the rollup.\n */\nexport type RollupContext = Record<string, unknown>;\n\n/**\n * The configuration for a rollup client.\n */\nexport type RollupConfig<C extends RollupContext> = {\n  /**\n   * The base URL of the rollup full node API.\n   */\n  url?: string;\n  /**\n   * The Sovereign SDK client to use for the rollup.\n   * If not provided, the default client will be used using {@link PartialRollupConfig.url}.\n   */\n  client: SovereignClient;\n  /**\n   * Creates the serializer instance to use for the rollup.\n   *\n   * This can be called more than once, for example if the chain hash changes (i.e a new rollup version)\n   * is detected then it will be called again with the new rollup schema.\n   */\n  getSerializer: (schema: RollupSchema) => Serializer;\n  /**\n   * Arbitrary context that is associated with the rollup.\n   */\n  context: C;\n  /**\n   * The endpoint path for submitting transactions.\n   * Defaults to \"/sequencer/txs\", the standard Sovereign SDK endpoint.\n   * Can be overridden if your rollup is configured to expose non-standard endpoints in\n   * order to support multiple different transaction encoding or authentication schemes.\n   */\n  txSubmissionEndpoint: string;\n};\n\n/**\n * The result of signing and submitting a transaction.\n *\n * @template Tx The type of the transaction\n */\nexport type TransactionResult<Tx> = {\n  /**\n   * The response from the sequencer.\n   */\n  response: SovereignClient.Sequencer.TxCreateResponse;\n  /**\n   * The transaction that was submitted.\n   */\n  transaction: Tx;\n};\n\n/**\n * The parameters for signing and submitting a transaction.\n */\nexport type SignerParams = {\n  /**\n   * The signer to use for signing the transaction.\n   */\n  signer: Signer;\n};\n\n/**\n * The parameters for calling executing a runtime call transaction.\n */\nexport type CallParams<S extends BaseTypeSpec> = {\n  overrides?: DeepPartial<S[\"UnsignedTransaction\"]>;\n} & SignerParams;\n\n/**\n * A generic rollup client.\n *\n * @template S - The type specification for the rollup.\n *               If not provided, the base type specification will be used which uses `any` for all types.\n * @template C - The context for the rollup.\n */\nexport class Rollup<S extends BaseTypeSpec, C extends RollupContext> {\n  private readonly _config: RollupConfig<C>;\n  private readonly _typeBuilder: TypeBuilder<S, C>;\n  private _chainHash?: Uint8Array;\n  private _serializer?: Serializer;\n\n  /**\n   * Creates a new rollup client.\n   *\n   * @param config - The configuration for the rollup client.\n   * @param typeBuilder - The type builder for the rollup.\n   */\n  constructor(config: RollupConfig<C>, typeBuilder: TypeBuilder<S, C>) {\n    this._config = config;\n    this._typeBuilder = typeBuilder;\n  }\n\n  /**\n   * Retrieve dedup information about the provided address.\n   *\n   * @param publicKey - The public key to dedup.\n   * TODO: How to add param for generation explicitly\n   */\n  async dedup(publicKey: Uint8Array): Promise<S[\"Dedup\"]> {\n    // for public key credential id is just its bytes representation\n    const credentialId = bytesToHex(publicKey);\n    const response = await this.rollup.addresses.dedup(credentialId);\n    return response as S[\"Dedup\"];\n  }\n\n  /**\n   * Submits a transaction to the rollup.\n   *\n   * The endpoint used for submission can be overridden via the options.path parameter.\n   * If not specified, the rollup's configured txSubmissionEndpoint will be used.\n   *\n   * @param transaction - The transaction to submit.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async submitTransaction(\n    transaction: S[\"Transaction\"],\n    options?: SovereignClient.RequestOptions,\n  ): Promise<SovereignClient.Sequencer.TxCreateResponse> {\n    const serializer = await this.serializer();\n    const serializedTx = serializer.serializeTx(transaction);\n    // Stainless RequestOptions is generic internally, causing issues for `body` and `query`.\n    // That's fine since we supply the `body` and transaction submission doesn't take query parameters.\n    // So we hack around this by destructuring them out.\n    const { body: _, query: __, path, ...requestOptions } = options || {};\n    const txSubmissionEndpoint = path || this._config.txSubmissionEndpoint;\n\n    return this.http\n      .post<SovereignClient.Sequencer.TxCreateResponse>(txSubmissionEndpoint, {\n        body: { body: Base64.fromUint8Array(serializedTx) },\n        ...requestOptions,\n      })\n      .catch(async (e) => {\n        if (isVersionMismatchError(e as APIError)) {\n          const oldVersion = bytesToHex(await this.chainHash());\n          const { schema, chain_hash: newVersion } = await this.rollup.schema();\n          this._chainHash = hexToBytes(newVersion);\n          this._serializer = this._config.getSerializer(schema);\n\n          if (oldVersion !== newVersion) {\n            throw new VersionMismatchError(\n              \"Schema version mismatch when submitting transaction\",\n              newVersion,\n              oldVersion,\n            );\n          }\n        }\n        throw e;\n      });\n  }\n\n  /**\n   * Signs and submits a transaction to the rollup.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign and submit.\n   * @param {SignerParams} params - The params for signing and submitting the transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.\n   */\n  async signAndSubmitTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    { signer }: SignerParams,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const tx = await this.signTransaction(unsignedTx, signer);\n    const result = await this.submitTransaction(tx, options);\n\n    return { transaction: tx, response: result };\n  }\n\n  /**\n   * Performs a runtime call transaction.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param runtimeCall - The runtime message to call.\n   * @param {CallParams<S>} params - The params for submitting a runtime call transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async call(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n\n    return this.signAndSubmitTransaction(\n      unsignedTx,\n      {\n        signer,\n      },\n      options,\n    );\n  }\n\n  /**\n   * Prepares a runtime call by creating and signing a transaction without submitting it.\n   * This is useful for scenarios where you need the signed transaction for later submission\n   * or for analysis purposes.\n   *\n   * @param runtimeCall - The runtime message to prepare.\n   * @param params - The parameters for preparing the call.\n   * @param params.signer - The signer to use for signing the transaction.\n   * @param params.overrides - Optional overrides for the unsigned transaction.\n   * @returns A promise that resolves to the signed transaction.\n   */\n  async prepareCall(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n  ): Promise<S[\"Transaction\"]> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n    return this.signTransaction(unsignedTx, signer);\n  }\n\n  /**\n   * Signs an unsigned transaction using the provided signer.\n   * Creates a signature by combining the serialized unsigned transaction with the chain hash,\n   * then constructs a fully signed transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign.\n   * @param signer - The signer to use for signing the transaction.\n   * @returns A promise that resolves to the signed transaction.\n   */\n  async signTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    signer: Signer,\n  ): Promise<S[\"Transaction\"]> {\n    const serializer = await this.serializer();\n    const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);\n    const chainHash = await this.chainHash();\n    const signature = await signer.sign(\n      new Uint8Array([...serializedUnsignedTx, ...chainHash]),\n    );\n    const publicKey = await signer.publicKey();\n    const context = {\n      unsignedTx,\n      sender: publicKey,\n      signature,\n      rollup: this,\n    };\n    return this._typeBuilder.transaction(context);\n  }\n\n  /**\n   * Create a subscription to events emitted over websockets by the rollup.\n   */\n  subscribe<T extends keyof SubscriptionToCallbackMap>(\n    type: T,\n    callback: SubscriptionToCallbackMap[T],\n  ): Subscription {\n    return createSubscription(type, callback, this.http);\n  }\n\n  /**\n   * Performs a healthcheck against the rollup to determine if it is currently healthy.\n   *\n   * @param timeout - Request timeout in milliseconds.\n   * @returns `true` if the rollup is considered healthy otherwise `false`.\n   */\n  async healthcheck(timeout = 5000): Promise<boolean> {\n    try {\n      await this.http.get(\"/healthcheck\", { timeout, maxRetries: 1 });\n      return true;\n    } catch (e) {\n      return !(e instanceof SovereignClient.APIConnectionError);\n    }\n  }\n\n  /**\n   * A ledger client that can be used to query the ledger.\n   */\n  get ledger(): SovereignClient.Ledger {\n    return this.http.ledger;\n  }\n\n  /**\n   * A sequencer client that can be used to submit transactions & batches to the rollup.\n   */\n  get sequencer(): SovereignClient.Sequencer {\n    return this.http.sequencer;\n  }\n\n  /**\n   * A rollup client that can be used to perform operations on the rollup.\n   */\n  get rollup(): SovereignClient.Rollup {\n    return this.http.rollup;\n  }\n\n  /**\n   * A client that can be used to perform HTTP requests to the Sovereign API.\n   * This can be used as an escape hatch to execute arbitrary requests to the Sovereign API\n   * if the operation is not supported by `ledger`, `sequencer`, or `rollup` clients.\n   */\n  get http(): SovereignClient {\n    return this._config.client;\n  }\n\n  /**\n   * The serializer for the rollup.\n   * Can be used to serialize transactions, runtime calls, etc.\n   */\n  async serializer(): Promise<Serializer> {\n    if (this._serializer) return this._serializer;\n    const { schema } = await this.rollup.schema();\n    this._serializer = this._config.getSerializer(schema);\n    return this._serializer;\n  }\n\n  /**\n   * The context for the rollup.\n   */\n  get context(): C {\n    return this._config.context;\n  }\n\n  async chainHash(): Promise<Uint8Array> {\n    if (this._chainHash) return this._chainHash;\n    const { chain_hash } = await this.rollup.schema();\n    this._chainHash = hexToBytes(chain_hash);\n    return this._chainHash;\n  }\n}\n\nfunction isVersionMismatchError(e: APIError): boolean {\n  if (\n    // biome-ignore lint/suspicious/noExplicitAny: yolo\n    (e.error as any)?.details?.error?.includes(\"Signature verification failed\")\n  ) {\n    return true;\n  }\n\n  return false;\n}\n","/**\n * Base error class for Sovereign SDK Web3.\n */\nexport class SovereignError extends Error {\n  constructor(message: string) {\n    super(message);\n\n    this.name = this.constructor.name;\n    this.stack = new Error().stack;\n  }\n}\n\nexport class InvalidRollupConfigError extends SovereignError {}\n\nexport class VersionMismatchError extends SovereignError {\n  public readonly newVersion: string;\n  public readonly currentVersion: string;\n  public readonly retryable: boolean;\n\n  constructor(message: string, newVersion: string, currentVersion: string) {\n    super(message);\n\n    this.newVersion = newVersion;\n    this.currentVersion = currentVersion;\n    this.retryable = newVersion !== currentVersion;\n  }\n}\n\nexport class SchemaError extends SovereignError {\n  public readonly schema: object;\n  public readonly reason: string;\n\n  constructor(message: string, reason: string, schema: object) {\n    super(`${message}: ${reason}`);\n\n    this.reason = reason;\n    this.schema = schema;\n  }\n}\n","import type SovereignSDK from \"@sovereign-sdk/client\";\nimport IsoWebSocket from \"isomorphic-ws\";\nimport { WebSocket } from \"partysocket\";\nimport { SovereignError } from \"./errors\";\n\ntype Url = string;\n\nexport function httpToWebSocket(url: string) {\n  return url.replace(/^http(s?):\\/\\//, (_, s) => `ws${s}://`);\n}\n\nexport type Subscription = {\n  /** Url providing the subscription. */\n  url: Url;\n  /** Unsubscribe this subscription. */\n  unsubscribe: () => void;\n};\n\ntype SubscriptionEntry = {\n  websocket: WebSocket;\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callbacks: Array<(...args: any[]) => void>;\n};\n\nexport const _subscriptions: Record<Url, SubscriptionEntry> = {};\n\n/** Subscribe to the provided websocket url & call the provided callback on messages received. */\nexport function subscribe(\n  url: Url,\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callback: (...args: any[]) => void,\n): Subscription {\n  const subscription = _subscriptions[url];\n\n  if (!subscription) {\n    const websocket = new WebSocket(url, [], { WebSocket: IsoWebSocket });\n    // bun compatibility: https://github.com/partykit/partykit/issues/774\n    websocket.binaryType = \"arraybuffer\";\n\n    _subscriptions[url] = {\n      websocket,\n      callbacks: [callback],\n    };\n\n    websocket.addEventListener(\"message\", (message) => {\n      const data = JSON.parse(message.data);\n      const callbacks = _subscriptions[url]?.callbacks;\n      if (callbacks) {\n        for (const cb of callbacks) {\n          cb(data);\n        }\n      }\n    });\n    websocket.addEventListener(\"error\", (e) =>\n      console.log(\"Websocket error\", e),\n    );\n  } else {\n    subscription.callbacks.push(callback);\n  }\n\n  const callbackIndex = _subscriptions[url]?.callbacks.length - 1;\n\n  return {\n    get url() {\n      return url;\n    },\n    unsubscribe() {\n      const subscription = _subscriptions[url];\n\n      if (!subscription) {\n        return;\n      }\n\n      subscription.callbacks.splice(callbackIndex, 1);\n\n      if (!subscription.callbacks.length) {\n        subscription.websocket.close();\n        delete _subscriptions[url];\n      }\n    },\n  };\n}\n\nexport type EventPayload = {\n  tx_hash: string;\n  type: \"event\";\n  number: number;\n  key: string;\n  value: Record<string, unknown>;\n  module: {\n    type: \"moduleRef\";\n    name: string;\n  };\n};\n\nexport interface SubscriptionToCallbackMap {\n  events: (event: EventPayload) => Promise<void>;\n}\n\nexport function createSubscription<T extends keyof SubscriptionToCallbackMap>(\n  subscription: T,\n  callback: SubscriptionToCallbackMap[T],\n  client: SovereignSDK,\n): Subscription {\n  switch (subscription) {\n    case \"events\": {\n      const url = client.buildURL(\"/sequencer/events/ws\", {});\n      return subscribe(\n        httpToWebSocket(url),\n        callback as SubscriptionToCallbackMap[\"events\"],\n      );\n    }\n    default:\n      throw new SovereignError(`Invalid subscription type '${subscription}'`);\n  }\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport { JsSerializer } from \"@sovereign-sdk/serializers\";\nimport { type HexString, bytesToHex } from \"@sovereign-sdk/utils\";\nimport type { DeepPartial } from \"../utils\";\nimport {\n  Rollup,\n  type RollupConfig,\n  type SignerParams,\n  type TransactionContext,\n  type TypeBuilder,\n  type UnsignedTransactionContext,\n} from \"./rollup\";\n\nexport type TxDetails = {\n  max_priority_fee_bips: number;\n  max_fee: string;\n  gas_limit: number[] | null;\n  chain_id: number;\n};\n\nexport type Generation = { generation: number };\nexport type Nonce = { nonce: number };\nexport type Uniqueness = Nonce | Generation;\n\nexport type UnsignedTransaction<RuntimeCall> = {\n  runtime_call: RuntimeCall;\n  uniqueness: Uniqueness;\n  details: TxDetails;\n};\n\nexport type TransactionV0<RuntimeCall> = {\n  pub_key: HexString;\n  signature: HexString;\n} & UnsignedTransaction<RuntimeCall>;\n\nexport type Transaction<RuntimeCall> = {\n  V0: TransactionV0<RuntimeCall>;\n};\n\nexport type Dedup = {\n  nonce: number;\n};\n\nexport type StandardRollupContext = {\n  defaultTxDetails: TxDetails;\n};\n\nexport type StandardRollupSpec<RuntimeCall> = {\n  UnsignedTransaction: UnsignedTransaction<RuntimeCall>;\n  Transaction: Transaction<RuntimeCall>;\n  RuntimeCall: RuntimeCall;\n  Dedup: Dedup;\n};\n\nconst useOrFetchUniqueness = async <S extends StandardRollupSpec<unknown>>({\n  overrides,\n}: Omit<\n  UnsignedTransactionContext<S, StandardRollupContext>,\n  \"runtimeCall\"\n>) => {\n  if (overrides?.uniqueness) {\n    return overrides.uniqueness;\n  }\n\n  return { generation: Date.now() };\n};\n\nexport function standardTypeBuilder<\n  S extends StandardRollupSpec<unknown>,\n>(): TypeBuilder<S, StandardRollupContext> {\n  return {\n    async unsignedTransaction(\n      context: UnsignedTransactionContext<S, StandardRollupContext>,\n    ) {\n      const { rollup, runtimeCall } = context;\n      const { uniqueness: _, ...overrides } = context.overrides;\n      const uniqueness = await useOrFetchUniqueness(context);\n      const details: TxDetails = {\n        ...rollup.context.defaultTxDetails,\n        ...overrides.details,\n      };\n\n      return {\n        runtime_call: runtimeCall,\n        uniqueness,\n        details,\n      } as S[\"UnsignedTransaction\"];\n    },\n    async transaction({\n      sender,\n      signature,\n      unsignedTx,\n    }: TransactionContext<S, StandardRollupContext>) {\n      return {\n        V0: {\n          pub_key: bytesToHex(sender),\n          signature: bytesToHex(signature),\n          ...unsignedTx,\n        },\n      };\n    },\n  };\n}\n\n/**\n * The parameters for simulating a runtime call transaction.\n */\nexport type SimulateParams = Omit<\n  SovereignClient.RollupSimulateParams,\n  \"call\" | \"sender\"\n> &\n  SignerParams;\n\nexport class StandardRollup<RuntimeCall> extends Rollup<\n  StandardRollupSpec<RuntimeCall>,\n  StandardRollupContext\n> {\n  /**\n   * Simulates a runtime call transaction.\n   *\n   * This method can be useful to estimate the gas cost of a runtime call transaction.\n   *\n   * @param runtimeMessage - The runtime message to call.\n   */\n  async simulate(\n    runtimeMessage: StandardRollupSpec<RuntimeCall>[\"RuntimeCall\"],\n    { signer }: SimulateParams,\n  ): Promise<SovereignClient.Rollup.RollupSimulateResponse> {\n    const publicKey = await signer.publicKey();\n    const sender = bytesToHex(publicKey);\n    const call = runtimeMessage as { [key: string]: unknown };\n\n    return this.rollup.simulate({ sender, call });\n  }\n}\n\nexport const DEFAULT_TX_DETAILS: Omit<TxDetails, \"chain_id\"> = {\n  max_priority_fee_bips: 0,\n  max_fee: \"100000000\",\n  gas_limit: null,\n};\n\nasync function buildContext<C extends StandardRollupContext>(\n  client: SovereignClient,\n  context?: DeepPartial<C>,\n): Promise<C> {\n  const defaultTxDetails = {\n    ...DEFAULT_TX_DETAILS,\n    ...context?.defaultTxDetails,\n  };\n\n  if (!defaultTxDetails.chain_id) {\n    const { chain_id } = await client.rollup.constants();\n\n    defaultTxDetails.chain_id = chain_id;\n  }\n\n  return {\n    defaultTxDetails,\n  } as C;\n}\n\nexport async function createStandardRollup<\n  RuntimeCall,\n  C extends StandardRollupContext = StandardRollupContext,\n>(\n  rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>,\n  typeBuilderOverrides?: Partial<\n    TypeBuilder<StandardRollupSpec<RuntimeCall>, C>\n  >,\n) {\n  const config = rollupConfig ?? {};\n  const client = config.client ?? new SovereignClient({ baseURL: config.url });\n  const getSerializer =\n    config.getSerializer ?? ((schema) => new JsSerializer(schema));\n  const context = await buildContext<C>(client, config.context);\n\n  // Default to the standard transaction submission endpoint\n  const txSubmissionEndpoint = config.txSubmissionEndpoint ?? \"/sequencer/txs\";\n\n  return new StandardRollup<RuntimeCall>(\n    {\n      ...config,\n      client,\n      getSerializer,\n      context,\n      txSubmissionEndpoint,\n    },\n    {\n      ...standardTypeBuilder(),\n      ...typeBuilderOverrides,\n    },\n  );\n}\n"],"mappings":"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","names":["SovereignClient","import_utils","IsoWebSocket","_a","subscription","SovereignClient","import_client","import_utils","_a","SovereignClient","SovereignClient"]}

package/dist/index.mjs

@@ -174,17 +174,22 @@ var Rollup = class {
   /**
    * Retrieve dedup information about the provided address.
    *
-   * @param address - The public key to dedup.
+   * @param publicKey - The public key to dedup.
+   * TODO: How to add param for generation explicitly
    */
-  dedup(address) {
+  dedup(publicKey) {
     return __async(this, null, function* () {
-      const response = yield this.rollup.addresses.dedup(bytesToHex(address));
+      const credentialId = bytesToHex(publicKey);
+      const response = yield this.rollup.addresses.dedup(credentialId);
       return response;
     });
   }
   /**
    * Submits a transaction to the rollup.
    *
+   * The endpoint used for submission can be overridden via the options.path parameter.
+   * If not specified, the rollup's configured txSubmissionEndpoint will be used.
+   *
    * @param transaction - The transaction to submit.
    * @param {SovereignClient.RequestOptions} options - The options for the request.
    */
@@ -192,10 +197,14 @@ var Rollup = class {
     return __async(this, null, function* () {
       const serializer = yield this.serializer();
       const serializedTx = serializer.serializeTx(transaction);
-      return this.sequencer.txs.create({ body: Base64.fromUint8Array(serializedTx) }, options).catch((e) => __async(this, null, function* () {
+      const _a = options || {}, { body: _, query: __, path } = _a, requestOptions = __objRest(_a, ["body", "query", "path"]);
+      const txSubmissionEndpoint = path || this._config.txSubmissionEndpoint;
+      return this.http.post(txSubmissionEndpoint, __spreadValues({
+        body: { body: Base64.fromUint8Array(serializedTx) }
+      }, requestOptions)).catch((e) => __async(this, null, function* () {
         if (isVersionMismatchError(e)) {
           const oldVersion = bytesToHex(yield this.chainHash());
-          const { schema, chain_hash: newVersion } = yield this.rollup.schema.retrieve();
+          const { schema, chain_hash: newVersion } = yield this.rollup.schema();
           this._chainHash = hexToBytes(newVersion);
           this._serializer = this._config.getSerializer(schema);
           if (oldVersion !== newVersion) {
@@ -217,23 +226,11 @@ var Rollup = class {
    * @param unsignedTx - The unsigned transaction to sign and submit.
    * @param {SignerParams} params - The params for signing and submitting the transaction.
    * @param {SovereignClient.RequestOptions} options - The options for the request.
+   * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.
    */
   signAndSubmitTransaction(_0, _1, _2) {
     return __async(this, arguments, function* (unsignedTx, { signer }, options) {
-      const serializer = yield this.serializer();
-      const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);
-      const chainHash = yield this.chainHash();
-      const signature = yield signer.sign(
-        new Uint8Array([...serializedUnsignedTx, ...chainHash])
-      );
-      const publicKey = yield signer.publicKey();
-      const context = {
-        unsignedTx,
-        sender: publicKey,
-        signature,
-        rollup: this
-      };
-      const tx = yield this._typeBuilder.transaction(context);
+      const tx = yield this.signTransaction(unsignedTx, signer);
       const result = yield this.submitTransaction(tx, options);
       return { transaction: tx, response: result };
     });
@@ -263,6 +260,55 @@ var Rollup = class {
       );
     });
   }
+  /**
+   * Prepares a runtime call by creating and signing a transaction without submitting it.
+   * This is useful for scenarios where you need the signed transaction for later submission
+   * or for analysis purposes.
+   *
+   * @param runtimeCall - The runtime message to prepare.
+   * @param params - The parameters for preparing the call.
+   * @param params.signer - The signer to use for signing the transaction.
+   * @param params.overrides - Optional overrides for the unsigned transaction.
+   * @returns A promise that resolves to the signed transaction.
+   */
+  prepareCall(_0, _1) {
+    return __async(this, arguments, function* (runtimeCall, { signer, overrides }) {
+      const context = {
+        runtimeCall,
+        rollup: this,
+        overrides: overrides != null ? overrides : {}
+      };
+      const unsignedTx = yield this._typeBuilder.unsignedTransaction(context);
+      return this.signTransaction(unsignedTx, signer);
+    });
+  }
+  /**
+   * Signs an unsigned transaction using the provided signer.
+   * Creates a signature by combining the serialized unsigned transaction with the chain hash,
+   * then constructs a fully signed transaction.
+   *
+   * @param unsignedTx - The unsigned transaction to sign.
+   * @param signer - The signer to use for signing the transaction.
+   * @returns A promise that resolves to the signed transaction.
+   */
+  signTransaction(unsignedTx, signer) {
+    return __async(this, null, function* () {
+      const serializer = yield this.serializer();
+      const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);
+      const chainHash = yield this.chainHash();
+      const signature = yield signer.sign(
+        new Uint8Array([...serializedUnsignedTx, ...chainHash])
+      );
+      const publicKey = yield signer.publicKey();
+      const context = {
+        unsignedTx,
+        sender: publicKey,
+        signature,
+        rollup: this
+      };
+      return this._typeBuilder.transaction(context);
+    });
+  }
   /**
    * Create a subscription to events emitted over websockets by the rollup.
    */
@@ -318,7 +364,7 @@ var Rollup = class {
   serializer() {
     return __async(this, null, function* () {
       if (this._serializer) return this._serializer;
-      const { schema } = yield this.rollup.schema.retrieve();
+      const { schema } = yield this.rollup.schema();
       this._serializer = this._config.getSerializer(schema);
       return this._serializer;
     });
@@ -332,7 +378,7 @@ var Rollup = class {
   chainHash() {
     return __async(this, null, function* () {
       if (this._chainHash) return this._chainHash;
-      const { chain_hash } = yield this.rollup.schema.retrieve();
+      const { chain_hash } = yield this.rollup.schema();
       this._chainHash = hexToBytes(chain_hash);
       return this._chainHash;
     });
@@ -383,16 +429,10 @@ function standardTypeBuilder() {
         unsignedTx
       }) {
         return {
-          versioned_tx: {
-            V0: __spreadValues({
-              pub_key: {
-                pub_key: sender
-              },
-              signature: {
-                msg_sig: signature
-              }
-            }, unsignedTx)
-          }
+          V0: __spreadValues({
+            pub_key: bytesToHex2(sender),
+            signature: bytesToHex2(signature)
+          }, unsignedTx)
         };
       });
     }
@@ -407,29 +447,11 @@ var StandardRollup = class extends Rollup {
    * @param runtimeMessage - The runtime message to call.
    */
   simulate(_0, _1) {
-    return __async(this, arguments, function* (runtimeMessage, { signer, txDetails, generation: overrideGeneration }) {
-      const serializer = yield this.serializer();
-      const runtimeCall = serializer.serializeRuntimeCall(runtimeMessage);
+    return __async(this, arguments, function* (runtimeMessage, { signer }) {
       const publicKey = yield signer.publicKey();
-      const uniqueness = yield useOrFetchUniqueness({
-        rollup: this,
-        overrides: {
-          uniqueness: overrideGeneration ? { generation: overrideGeneration } : void 0
-        }
-      });
-      const generation = "generation" in uniqueness ? uniqueness.generation : uniqueness.nonce;
-      const response = yield this.rollup.simulate({
-        body: {
-          details: __spreadProps(__spreadValues({}, txDetails), {
-            // simulate needs this field as `undefined` currently
-            gas_limit: txDetails.gas_limit || void 0
-          }),
-          encoded_call_message: bytesToHex2(runtimeCall),
-          generation,
-          sender_pub_key: bytesToHex2(publicKey)
-        }
-      });
-      return response;
+      const sender = bytesToHex2(publicKey);
+      const call = runtimeMessage;
+      return this.rollup.simulate({ sender, call });
     });
   }
 };
@@ -442,7 +464,7 @@ function buildContext(client, context) {
   return __async(this, null, function* () {
     const defaultTxDetails = __spreadValues(__spreadValues({}, DEFAULT_TX_DETAILS), context == null ? void 0 : context.defaultTxDetails);
     if (!defaultTxDetails.chain_id) {
-      const { chain_id } = yield client.rollup.constants.retrieve();
+      const { chain_id } = yield client.rollup.constants();
       defaultTxDetails.chain_id = chain_id;
     }
     return {
@@ -452,13 +474,19 @@ function buildContext(client, context) {
 }
 function createStandardRollup(rollupConfig, typeBuilderOverrides) {
   return __async(this, null, function* () {
-    var _a, _b;
+    var _a, _b, _c;
     const config = rollupConfig != null ? rollupConfig : {};
     const client = (_a = config.client) != null ? _a : new SovereignClient2({ baseURL: config.url });
     const getSerializer = (_b = config.getSerializer) != null ? _b : (schema) => new JsSerializer(schema);
     const context = yield buildContext(client, config.context);
+    const txSubmissionEndpoint = (_c = config.txSubmissionEndpoint) != null ? _c : "/sequencer/txs";
     return new StandardRollup(
-      __spreadProps(__spreadValues({}, config), { client, getSerializer, context }),
+      __spreadProps(__spreadValues({}, config), {
+        client,
+        getSerializer,
+        context,
+        txSubmissionEndpoint
+      }),
       __spreadValues(__spreadValues({}, standardTypeBuilder()), typeBuilderOverrides)
     );
   });

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addresses.ts","../src/rollup/rollup.ts","../src/errors.ts","../src/subscriptions.ts","../src/rollup/standard-rollup.ts","../src/index.ts"],"sourcesContent":["import { type HexString, ensureBytes } from \"@sovereign-sdk/utils\";\nimport { bech32m } from \"bech32\";\n\n/**\n * Encodes a public key as a bech32m address with the given human-readable part (hrp).\n *\n * @param publicKey - The public key to encode, as a hex string or Uint8Array.\n * @param hrp - The human-readable part for the bech32m address (e.g., \"sov\").\n * @param concatPublicKey - Optional. If provided, only the first `concatPublicKey` bytes of the public key are used.\n * @returns The bech32m-encoded address as a string.\n * @throws {Error} If the public key is not a valid hex string or Uint8Array.\n */\nexport function addressFromPublicKey(\n  publicKey: HexString | Uint8Array,\n  hrp: string,\n  concatPublicKey = 28,\n): string {\n  let publicKeyBytes = ensureBytes(publicKey);\n\n  if (concatPublicKey !== publicKey.length) {\n    publicKeyBytes = publicKeyBytes.slice(0, concatPublicKey);\n  }\n\n  const words = bech32m.toWords(publicKeyBytes);\n  return bech32m.encode(hrp, words);\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport type { APIError } from \"@sovereign-sdk/client\";\nimport type { RollupSchema, Serializer } from \"@sovereign-sdk/serializers\";\nimport type { Signer } from \"@sovereign-sdk/signers\";\nimport { bytesToHex, hexToBytes } from \"@sovereign-sdk/utils\";\nimport { Base64 } from \"js-base64\";\nimport { VersionMismatchError } from \"../errors\";\nimport {\n  type Subscription,\n  type SubscriptionToCallbackMap,\n  createSubscription,\n} from \"../subscriptions\";\nimport type { BaseTypeSpec } from \"../type-spec\";\nimport type { DeepPartial } from \"../utils\";\n\nexport type UnsignedTransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  runtimeCall: S[\"RuntimeCall\"];\n  // Provides the ability to override the generation data instead of retrieving it automatically.\n  overrides: DeepPartial<S[\"UnsignedTransaction\"]>;\n  rollup: Rollup<S, C>;\n};\n\nexport type TransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  unsignedTx: S[\"UnsignedTransaction\"];\n  sender: Uint8Array;\n  signature: Uint8Array;\n  rollup: Rollup<S, C>;\n};\n\nexport type TypeBuilder<S extends BaseTypeSpec, C extends RollupContext> = {\n  unsignedTransaction: (\n    context: UnsignedTransactionContext<S, C>,\n  ) => Promise<S[\"UnsignedTransaction\"]>;\n\n  transaction: (context: TransactionContext<S, C>) => Promise<S[\"Transaction\"]>;\n};\n\n/**\n * Arbitrary context that is associated with the rollup.\n */\nexport type RollupContext = Record<string, unknown>;\n\n/**\n * The configuration for a rollup client.\n */\nexport type RollupConfig<C extends RollupContext> = {\n  /**\n   * The base URL of the rollup full node API.\n   */\n  url?: string;\n  /**\n   * The Sovereign SDK client to use for the rollup.\n   * If not provided, the default client will be used using {@link PartialRollupConfig.url}.\n   */\n  client: SovereignClient;\n  /**\n   * Creates the serializer instance to use for the rollup.\n   *\n   * This can be called more than once, for example if the chain hash changes (i.e a new rollup version)\n   * is detected then it will be called again with the new rollup schema.\n   */\n  getSerializer: (schema: RollupSchema) => Serializer;\n  /**\n   * Arbitrary context that is associated with the rollup.\n   */\n  context: C;\n};\n\n/**\n * The result of signing and submitting a transaction.\n *\n * @template Tx The type of the transaction\n */\nexport type TransactionResult<Tx> = {\n  /**\n   * The response from the sequencer.\n   */\n  response: SovereignClient.Sequencer.TxCreateResponse;\n  /**\n   * The transaction that was submitted.\n   */\n  transaction: Tx;\n};\n\n/**\n * The parameters for signing and submitting a transaction.\n */\nexport type SignerParams = {\n  /**\n   * The signer to use for signing the transaction.\n   */\n  signer: Signer;\n};\n\n/**\n * The parameters for calling executing a runtime call transaction.\n */\nexport type CallParams<S extends BaseTypeSpec> = {\n  overrides?: DeepPartial<S[\"UnsignedTransaction\"]>;\n} & SignerParams;\n\n/**\n * A generic rollup client.\n *\n * @template S - The type specification for the rollup.\n *               If not provided, the base type specification will be used which uses `any` for all types.\n * @template C - The context for the rollup.\n */\nexport class Rollup<S extends BaseTypeSpec, C extends RollupContext> {\n  private readonly _config: RollupConfig<C>;\n  private readonly _typeBuilder: TypeBuilder<S, C>;\n  private _chainHash?: Uint8Array;\n  private _serializer?: Serializer;\n\n  /**\n   * Creates a new rollup client.\n   *\n   * @param config - The configuration for the rollup client.\n   * @param typeBuilder - The type builder for the rollup.\n   */\n  constructor(config: RollupConfig<C>, typeBuilder: TypeBuilder<S, C>) {\n    this._config = config;\n    this._typeBuilder = typeBuilder;\n  }\n\n  /**\n   * Retrieve dedup information about the provided address.\n   *\n   * @param address - The public key to dedup.\n   */\n  async dedup(address: Uint8Array): Promise<S[\"Dedup\"]> {\n    const response = await this.rollup.addresses.dedup(bytesToHex(address));\n    return response as S[\"Dedup\"];\n  }\n\n  /**\n   * Submits a transaction to the rollup.\n   *\n   * @param transaction - The transaction to submit.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async submitTransaction(\n    transaction: S[\"Transaction\"],\n    options?: SovereignClient.RequestOptions,\n  ): Promise<SovereignClient.Sequencer.TxCreateResponse> {\n    const serializer = await this.serializer();\n    const serializedTx = serializer.serializeTx(transaction);\n\n    return this.sequencer.txs\n      .create({ body: Base64.fromUint8Array(serializedTx) }, options)\n      .catch(async (e) => {\n        if (isVersionMismatchError(e as APIError)) {\n          const oldVersion = bytesToHex(await this.chainHash());\n          const { schema, chain_hash: newVersion } =\n            await this.rollup.schema.retrieve();\n          this._chainHash = hexToBytes(newVersion);\n          this._serializer = this._config.getSerializer(schema);\n\n          if (oldVersion !== newVersion) {\n            throw new VersionMismatchError(\n              \"Schema version mismatch when submitting transaction\",\n              newVersion,\n              oldVersion,\n            );\n          }\n        }\n        throw e;\n      });\n  }\n\n  /**\n   * Signs and submits a transaction to the rollup.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign and submit.\n   * @param {SignerParams} params - The params for signing and submitting the transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async signAndSubmitTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    { signer }: SignerParams,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const serializer = await this.serializer();\n    const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);\n    const chainHash = await this.chainHash();\n    const signature = await signer.sign(\n      new Uint8Array([...serializedUnsignedTx, ...chainHash]),\n    );\n    const publicKey = await signer.publicKey();\n    const context = {\n      unsignedTx,\n      sender: publicKey,\n      signature,\n      rollup: this,\n    };\n    const tx = await this._typeBuilder.transaction(context);\n    const result = await this.submitTransaction(tx, options);\n\n    return { transaction: tx, response: result };\n  }\n\n  /**\n   * Performs a runtime call transaction.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param runtimeCall - The runtime message to call.\n   * @param {CallParams<S>} params - The params for submitting a runtime call transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async call(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n\n    return this.signAndSubmitTransaction(\n      unsignedTx,\n      {\n        signer,\n      },\n      options,\n    );\n  }\n\n  /**\n   * Create a subscription to events emitted over websockets by the rollup.\n   */\n  subscribe<T extends keyof SubscriptionToCallbackMap>(\n    type: T,\n    callback: SubscriptionToCallbackMap[T],\n  ): Subscription {\n    return createSubscription(type, callback, this.http);\n  }\n\n  /**\n   * Performs a healthcheck against the rollup to determine if it is currently healthy.\n   *\n   * @param timeout - Request timeout in milliseconds.\n   * @returns `true` if the rollup is considered healthy otherwise `false`.\n   */\n  async healthcheck(timeout = 5000): Promise<boolean> {\n    try {\n      await this.http.get(\"/healthcheck\", { timeout, maxRetries: 1 });\n      return true;\n    } catch (e) {\n      return !(e instanceof SovereignClient.APIConnectionError);\n    }\n  }\n\n  /**\n   * A ledger client that can be used to query the ledger.\n   */\n  get ledger(): SovereignClient.Ledger {\n    return this.http.ledger;\n  }\n\n  /**\n   * A sequencer client that can be used to submit transactions & batches to the rollup.\n   */\n  get sequencer(): SovereignClient.Sequencer {\n    return this.http.sequencer;\n  }\n\n  /**\n   * A rollup client that can be used to perform operations on the rollup.\n   */\n  get rollup(): SovereignClient.Rollup {\n    return this.http.rollup;\n  }\n\n  /**\n   * A client that can be used to perform HTTP requests to the Sovereign API.\n   * This can be used as an escape hatch to execute arbitrary requests to the Sovereign API\n   * if the operation is not supported by `ledger`, `sequencer`, or `rollup` clients.\n   */\n  get http(): SovereignClient {\n    return this._config.client;\n  }\n\n  /**\n   * The serializer for the rollup.\n   * Can be used to serialize transactions, runtime calls, etc.\n   */\n  async serializer(): Promise<Serializer> {\n    if (this._serializer) return this._serializer;\n    const { schema } = await this.rollup.schema.retrieve();\n    this._serializer = this._config.getSerializer(schema);\n    return this._serializer;\n  }\n\n  /**\n   * The context for the rollup.\n   */\n  get context(): C {\n    return this._config.context;\n  }\n\n  async chainHash(): Promise<Uint8Array> {\n    if (this._chainHash) return this._chainHash;\n    const { chain_hash } = await this.rollup.schema.retrieve();\n    this._chainHash = hexToBytes(chain_hash);\n    return this._chainHash;\n  }\n}\n\nfunction isVersionMismatchError(e: APIError): boolean {\n  if (\n    // biome-ignore lint/suspicious/noExplicitAny: yolo\n    (e.error as any)?.details?.error?.includes(\"Signature verification failed\")\n  ) {\n    return true;\n  }\n\n  return false;\n}\n","/**\n * Base error class for Sovereign SDK Web3.\n */\nexport class SovereignError extends Error {\n  constructor(message: string) {\n    super(message);\n\n    this.name = this.constructor.name;\n    this.stack = new Error().stack;\n  }\n}\n\nexport class InvalidRollupConfigError extends SovereignError {}\n\nexport class VersionMismatchError extends SovereignError {\n  public readonly newVersion: string;\n  public readonly currentVersion: string;\n  public readonly retryable: boolean;\n\n  constructor(message: string, newVersion: string, currentVersion: string) {\n    super(message);\n\n    this.newVersion = newVersion;\n    this.currentVersion = currentVersion;\n    this.retryable = newVersion !== currentVersion;\n  }\n}\n\nexport class SchemaError extends SovereignError {\n  public readonly schema: object;\n  public readonly reason: string;\n\n  constructor(message: string, reason: string, schema: object) {\n    super(`${message}: ${reason}`);\n\n    this.reason = reason;\n    this.schema = schema;\n  }\n}\n","import type SovereignSDK from \"@sovereign-sdk/client\";\nimport IsoWebSocket from \"isomorphic-ws\";\nimport { WebSocket } from \"partysocket\";\nimport { SovereignError } from \"./errors\";\n\ntype Url = string;\n\nexport function httpToWebSocket(url: string) {\n  return url.replace(/^http(s?):\\/\\//, (_, s) => `ws${s}://`);\n}\n\nexport type Subscription = {\n  /** Url providing the subscription. */\n  url: Url;\n  /** Unsubscribe this subscription. */\n  unsubscribe: () => void;\n};\n\ntype SubscriptionEntry = {\n  websocket: WebSocket;\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callbacks: Array<(...args: any[]) => void>;\n};\n\nexport const _subscriptions: Record<Url, SubscriptionEntry> = {};\n\n/** Subscribe to the provided websocket url & call the provided callback on messages received. */\nexport function subscribe(\n  url: Url,\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callback: (...args: any[]) => void,\n): Subscription {\n  const subscription = _subscriptions[url];\n\n  if (!subscription) {\n    const websocket = new WebSocket(url, [], { WebSocket: IsoWebSocket });\n    // bun compatibility: https://github.com/partykit/partykit/issues/774\n    websocket.binaryType = \"arraybuffer\";\n\n    _subscriptions[url] = {\n      websocket,\n      callbacks: [callback],\n    };\n\n    websocket.addEventListener(\"message\", (message) => {\n      const data = JSON.parse(message.data);\n      const callbacks = _subscriptions[url]?.callbacks;\n      if (callbacks) {\n        for (const cb of callbacks) {\n          cb(data);\n        }\n      }\n    });\n    websocket.addEventListener(\"error\", (e) =>\n      console.log(\"Websocket error\", e),\n    );\n  } else {\n    subscription.callbacks.push(callback);\n  }\n\n  const callbackIndex = _subscriptions[url]?.callbacks.length - 1;\n\n  return {\n    get url() {\n      return url;\n    },\n    unsubscribe() {\n      const subscription = _subscriptions[url];\n\n      if (!subscription) {\n        return;\n      }\n\n      subscription.callbacks.splice(callbackIndex, 1);\n\n      if (!subscription.callbacks.length) {\n        subscription.websocket.close();\n        delete _subscriptions[url];\n      }\n    },\n  };\n}\n\nexport type EventPayload = {\n  tx_hash: string;\n  type: \"event\";\n  number: number;\n  key: string;\n  value: Record<string, unknown>;\n  module: {\n    type: \"moduleRef\";\n    name: string;\n  };\n};\n\nexport interface SubscriptionToCallbackMap {\n  events: (event: EventPayload) => Promise<void>;\n}\n\nexport function createSubscription<T extends keyof SubscriptionToCallbackMap>(\n  subscription: T,\n  callback: SubscriptionToCallbackMap[T],\n  client: SovereignSDK,\n): Subscription {\n  switch (subscription) {\n    case \"events\": {\n      const url = client.buildURL(\"/sequencer/events/ws\", {});\n      return subscribe(\n        httpToWebSocket(url),\n        callback as SubscriptionToCallbackMap[\"events\"],\n      );\n    }\n    default:\n      throw new SovereignError(`Invalid subscription type '${subscription}'`);\n  }\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport { JsSerializer } from \"@sovereign-sdk/serializers\";\nimport { bytesToHex } from \"@sovereign-sdk/utils\";\nimport type { DeepPartial } from \"../utils\";\nimport {\n  Rollup,\n  type RollupConfig,\n  type SignerParams,\n  type TransactionContext,\n  type TypeBuilder,\n  type UnsignedTransactionContext,\n} from \"./rollup\";\n\nexport type TxDetails = {\n  max_priority_fee_bips: number;\n  max_fee: string;\n  gas_limit: number[] | null;\n  chain_id: number;\n};\n\nexport type Generation = { generation: number };\nexport type Nonce = { nonce: number };\nexport type Uniqueness = Nonce | Generation;\n\nexport type UnsignedTransaction<RuntimeCall> = {\n  runtime_call: RuntimeCall;\n  uniqueness: Uniqueness;\n  details: TxDetails;\n};\n\nexport type TransactionV0<RuntimeCall> = {\n  pub_key: { pub_key: Uint8Array };\n  signature: { msg_sig: Uint8Array };\n} & UnsignedTransaction<RuntimeCall>;\n\nexport type Transaction<RuntimeCall> = {\n  versioned_tx: { V0: TransactionV0<RuntimeCall> };\n};\n\nexport type Dedup = {\n  nonce: number;\n};\n\nexport type StandardRollupContext = {\n  defaultTxDetails: TxDetails;\n};\n\nexport type StandardRollupSpec<RuntimeCall> = {\n  UnsignedTransaction: UnsignedTransaction<RuntimeCall>;\n  Transaction: Transaction<RuntimeCall>;\n  RuntimeCall: RuntimeCall;\n  Dedup: Dedup;\n};\n\nconst useOrFetchUniqueness = async <S extends StandardRollupSpec<unknown>>({\n  overrides,\n}: Omit<\n  UnsignedTransactionContext<S, StandardRollupContext>,\n  \"runtimeCall\"\n>) => {\n  if (overrides?.uniqueness) {\n    return overrides.uniqueness;\n  }\n\n  return { generation: Date.now() };\n};\n\nexport function standardTypeBuilder<\n  S extends StandardRollupSpec<unknown>,\n>(): TypeBuilder<S, StandardRollupContext> {\n  return {\n    async unsignedTransaction(\n      context: UnsignedTransactionContext<S, StandardRollupContext>,\n    ) {\n      const { rollup, runtimeCall } = context;\n      const { uniqueness: _, ...overrides } = context.overrides;\n      const uniqueness = await useOrFetchUniqueness(context);\n      const details: TxDetails = {\n        ...rollup.context.defaultTxDetails,\n        ...overrides.details,\n      };\n\n      return {\n        runtime_call: runtimeCall,\n        uniqueness,\n        details,\n      } as S[\"UnsignedTransaction\"];\n    },\n    async transaction({\n      sender,\n      signature,\n      unsignedTx,\n    }: TransactionContext<S, StandardRollupContext>) {\n      return {\n        versioned_tx: {\n          V0: {\n            pub_key: {\n              pub_key: sender,\n            },\n            signature: {\n              msg_sig: signature,\n            },\n            ...unsignedTx,\n          },\n        },\n      };\n    },\n  };\n}\n\n/**\n * The parameters for simulating a runtime call transaction.\n */\nexport type SimulateParams = {\n  /**\n   * The transaction details to use for the simulation.\n   */\n  txDetails: TxDetails;\n\n  /** The generation of the transaction for uniquness purposes. */\n  generation?: number;\n} & SignerParams;\n\nexport class StandardRollup<RuntimeCall> extends Rollup<\n  StandardRollupSpec<RuntimeCall>,\n  StandardRollupContext\n> {\n  /**\n   * Simulates a runtime call transaction.\n   *\n   * This method can be useful to estimate the gas cost of a runtime call transaction.\n   *\n   * @param runtimeMessage - The runtime message to call.\n   */\n  async simulate(\n    runtimeMessage: StandardRollupSpec<RuntimeCall>[\"RuntimeCall\"],\n    { signer, txDetails, generation: overrideGeneration }: SimulateParams,\n  ): Promise<SovereignClient.Rollup.SimulateExecutionResponse> {\n    const serializer = await this.serializer();\n    const runtimeCall = serializer.serializeRuntimeCall(runtimeMessage);\n    const publicKey = await signer.publicKey();\n    const uniqueness = await useOrFetchUniqueness({\n      rollup: this,\n      overrides: {\n        uniqueness: overrideGeneration\n          ? { generation: overrideGeneration }\n          : undefined,\n      },\n    });\n    // Extract the generation number from the uniqueness object\n    const generation =\n      \"generation\" in uniqueness\n        ? (uniqueness as Generation).generation\n        : (uniqueness as Nonce).nonce; // Use nonce as fallback until simulate endpoint is updated.\n    const response = await this.rollup.simulate({\n      body: {\n        details: {\n          ...txDetails,\n          // simulate needs this field as `undefined` currently\n          gas_limit: txDetails.gas_limit || undefined,\n        },\n        encoded_call_message: bytesToHex(runtimeCall),\n        generation,\n        sender_pub_key: bytesToHex(publicKey),\n      },\n    });\n\n    return response;\n  }\n}\n\nexport const DEFAULT_TX_DETAILS: Omit<TxDetails, \"chain_id\"> = {\n  max_priority_fee_bips: 0,\n  max_fee: \"100000000\",\n  gas_limit: null,\n};\n\nasync function buildContext<C extends StandardRollupContext>(\n  client: SovereignClient,\n  context?: DeepPartial<C>,\n): Promise<C> {\n  const defaultTxDetails = {\n    ...DEFAULT_TX_DETAILS,\n    ...context?.defaultTxDetails,\n  };\n\n  if (!defaultTxDetails.chain_id) {\n    const { chain_id } = await client.rollup.constants.retrieve();\n\n    defaultTxDetails.chain_id = chain_id;\n  }\n\n  return {\n    defaultTxDetails,\n  } as C;\n}\n\nexport async function createStandardRollup<\n  RuntimeCall,\n  C extends StandardRollupContext = StandardRollupContext,\n>(\n  rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>,\n  typeBuilderOverrides?: Partial<\n    TypeBuilder<StandardRollupSpec<RuntimeCall>, C>\n  >,\n) {\n  const config = rollupConfig ?? {};\n  const client = config.client ?? new SovereignClient({ baseURL: config.url });\n  const getSerializer =\n    config.getSerializer ?? ((schema) => new JsSerializer(schema));\n  const context = await buildContext<C>(client, config.context);\n\n  return new StandardRollup<RuntimeCall>(\n    { ...config, client, getSerializer, context },\n    {\n      ...standardTypeBuilder(),\n      ...typeBuilderOverrides,\n    },\n  );\n}\n","export * from \"./addresses\";\nexport * from \"./rollup\";\nexport * from \"./errors\";\nexport * from \"./type-spec\";\nexport { type EventPayload, Subscription } from \"./subscriptions\";\nexport * as SovereignClient from \"@sovereign-sdk/client\";\n"],"mappings":"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","names":["_a","subscription","SovereignClient","bytesToHex","_a","bytesToHex","SovereignClient","SovereignClient"]}
+{"version":3,"sources":["../src/addresses.ts","../src/rollup/rollup.ts","../src/errors.ts","../src/subscriptions.ts","../src/rollup/standard-rollup.ts","../src/index.ts"],"sourcesContent":["import { type HexString, ensureBytes } from \"@sovereign-sdk/utils\";\nimport { bech32m } from \"bech32\";\n\n/**\n * Encodes a public key as a bech32m address with the given human-readable part (hrp).\n *\n * @param publicKey - The public key to encode, as a hex string or Uint8Array.\n * @param hrp - The human-readable part for the bech32m address (e.g., \"sov\").\n * @param concatPublicKey - Optional. If provided, only the first `concatPublicKey` bytes of the public key are used.\n * @returns The bech32m-encoded address as a string.\n * @throws {Error} If the public key is not a valid hex string or Uint8Array.\n */\nexport function addressFromPublicKey(\n  publicKey: HexString | Uint8Array,\n  hrp: string,\n  concatPublicKey = 28,\n): string {\n  let publicKeyBytes = ensureBytes(publicKey);\n\n  if (concatPublicKey !== publicKey.length) {\n    publicKeyBytes = publicKeyBytes.slice(0, concatPublicKey);\n  }\n\n  const words = bech32m.toWords(publicKeyBytes);\n  return bech32m.encode(hrp, words);\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport type { APIError } from \"@sovereign-sdk/client\";\nimport type { RollupSchema, Serializer } from \"@sovereign-sdk/serializers\";\nimport type { Signer } from \"@sovereign-sdk/signers\";\nimport { bytesToHex, hexToBytes } from \"@sovereign-sdk/utils\";\nimport { Base64 } from \"js-base64\";\nimport { VersionMismatchError } from \"../errors\";\nimport {\n  type Subscription,\n  type SubscriptionToCallbackMap,\n  createSubscription,\n} from \"../subscriptions\";\nimport type { BaseTypeSpec } from \"../type-spec\";\nimport type { DeepPartial } from \"../utils\";\n\nexport type UnsignedTransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  runtimeCall: S[\"RuntimeCall\"];\n  // Provides the ability to override the generation data instead of retrieving it automatically.\n  overrides: DeepPartial<S[\"UnsignedTransaction\"]>;\n  rollup: Rollup<S, C>;\n};\n\nexport type TransactionContext<\n  S extends BaseTypeSpec,\n  C extends RollupContext,\n> = {\n  unsignedTx: S[\"UnsignedTransaction\"];\n  sender: Uint8Array;\n  signature: Uint8Array;\n  rollup: Rollup<S, C>;\n};\n\nexport type TypeBuilder<S extends BaseTypeSpec, C extends RollupContext> = {\n  unsignedTransaction: (\n    context: UnsignedTransactionContext<S, C>,\n  ) => Promise<S[\"UnsignedTransaction\"]>;\n\n  transaction: (context: TransactionContext<S, C>) => Promise<S[\"Transaction\"]>;\n};\n\n/**\n * Arbitrary context that is associated with the rollup.\n */\nexport type RollupContext = Record<string, unknown>;\n\n/**\n * The configuration for a rollup client.\n */\nexport type RollupConfig<C extends RollupContext> = {\n  /**\n   * The base URL of the rollup full node API.\n   */\n  url?: string;\n  /**\n   * The Sovereign SDK client to use for the rollup.\n   * If not provided, the default client will be used using {@link PartialRollupConfig.url}.\n   */\n  client: SovereignClient;\n  /**\n   * Creates the serializer instance to use for the rollup.\n   *\n   * This can be called more than once, for example if the chain hash changes (i.e a new rollup version)\n   * is detected then it will be called again with the new rollup schema.\n   */\n  getSerializer: (schema: RollupSchema) => Serializer;\n  /**\n   * Arbitrary context that is associated with the rollup.\n   */\n  context: C;\n  /**\n   * The endpoint path for submitting transactions.\n   * Defaults to \"/sequencer/txs\", the standard Sovereign SDK endpoint.\n   * Can be overridden if your rollup is configured to expose non-standard endpoints in\n   * order to support multiple different transaction encoding or authentication schemes.\n   */\n  txSubmissionEndpoint: string;\n};\n\n/**\n * The result of signing and submitting a transaction.\n *\n * @template Tx The type of the transaction\n */\nexport type TransactionResult<Tx> = {\n  /**\n   * The response from the sequencer.\n   */\n  response: SovereignClient.Sequencer.TxCreateResponse;\n  /**\n   * The transaction that was submitted.\n   */\n  transaction: Tx;\n};\n\n/**\n * The parameters for signing and submitting a transaction.\n */\nexport type SignerParams = {\n  /**\n   * The signer to use for signing the transaction.\n   */\n  signer: Signer;\n};\n\n/**\n * The parameters for calling executing a runtime call transaction.\n */\nexport type CallParams<S extends BaseTypeSpec> = {\n  overrides?: DeepPartial<S[\"UnsignedTransaction\"]>;\n} & SignerParams;\n\n/**\n * A generic rollup client.\n *\n * @template S - The type specification for the rollup.\n *               If not provided, the base type specification will be used which uses `any` for all types.\n * @template C - The context for the rollup.\n */\nexport class Rollup<S extends BaseTypeSpec, C extends RollupContext> {\n  private readonly _config: RollupConfig<C>;\n  private readonly _typeBuilder: TypeBuilder<S, C>;\n  private _chainHash?: Uint8Array;\n  private _serializer?: Serializer;\n\n  /**\n   * Creates a new rollup client.\n   *\n   * @param config - The configuration for the rollup client.\n   * @param typeBuilder - The type builder for the rollup.\n   */\n  constructor(config: RollupConfig<C>, typeBuilder: TypeBuilder<S, C>) {\n    this._config = config;\n    this._typeBuilder = typeBuilder;\n  }\n\n  /**\n   * Retrieve dedup information about the provided address.\n   *\n   * @param publicKey - The public key to dedup.\n   * TODO: How to add param for generation explicitly\n   */\n  async dedup(publicKey: Uint8Array): Promise<S[\"Dedup\"]> {\n    // for public key credential id is just its bytes representation\n    const credentialId = bytesToHex(publicKey);\n    const response = await this.rollup.addresses.dedup(credentialId);\n    return response as S[\"Dedup\"];\n  }\n\n  /**\n   * Submits a transaction to the rollup.\n   *\n   * The endpoint used for submission can be overridden via the options.path parameter.\n   * If not specified, the rollup's configured txSubmissionEndpoint will be used.\n   *\n   * @param transaction - The transaction to submit.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async submitTransaction(\n    transaction: S[\"Transaction\"],\n    options?: SovereignClient.RequestOptions,\n  ): Promise<SovereignClient.Sequencer.TxCreateResponse> {\n    const serializer = await this.serializer();\n    const serializedTx = serializer.serializeTx(transaction);\n    // Stainless RequestOptions is generic internally, causing issues for `body` and `query`.\n    // That's fine since we supply the `body` and transaction submission doesn't take query parameters.\n    // So we hack around this by destructuring them out.\n    const { body: _, query: __, path, ...requestOptions } = options || {};\n    const txSubmissionEndpoint = path || this._config.txSubmissionEndpoint;\n\n    return this.http\n      .post<SovereignClient.Sequencer.TxCreateResponse>(txSubmissionEndpoint, {\n        body: { body: Base64.fromUint8Array(serializedTx) },\n        ...requestOptions,\n      })\n      .catch(async (e) => {\n        if (isVersionMismatchError(e as APIError)) {\n          const oldVersion = bytesToHex(await this.chainHash());\n          const { schema, chain_hash: newVersion } = await this.rollup.schema();\n          this._chainHash = hexToBytes(newVersion);\n          this._serializer = this._config.getSerializer(schema);\n\n          if (oldVersion !== newVersion) {\n            throw new VersionMismatchError(\n              \"Schema version mismatch when submitting transaction\",\n              newVersion,\n              oldVersion,\n            );\n          }\n        }\n        throw e;\n      });\n  }\n\n  /**\n   * Signs and submits a transaction to the rollup.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign and submit.\n   * @param {SignerParams} params - The params for signing and submitting the transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   * @param endpoint - Optional endpoint override. If not specified, uses the rollup's configured txSubmissionEndpoint.\n   */\n  async signAndSubmitTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    { signer }: SignerParams,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const tx = await this.signTransaction(unsignedTx, signer);\n    const result = await this.submitTransaction(tx, options);\n\n    return { transaction: tx, response: result };\n  }\n\n  /**\n   * Performs a runtime call transaction.\n   * Utilizes the provided signer to sign the transaction.\n   *\n   * @param runtimeCall - The runtime message to call.\n   * @param {CallParams<S>} params - The params for submitting a runtime call transaction.\n   * @param {SovereignClient.RequestOptions} options - The options for the request.\n   */\n  async call(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n    options?: SovereignClient.RequestOptions,\n  ): Promise<TransactionResult<S[\"Transaction\"]>> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n\n    return this.signAndSubmitTransaction(\n      unsignedTx,\n      {\n        signer,\n      },\n      options,\n    );\n  }\n\n  /**\n   * Prepares a runtime call by creating and signing a transaction without submitting it.\n   * This is useful for scenarios where you need the signed transaction for later submission\n   * or for analysis purposes.\n   *\n   * @param runtimeCall - The runtime message to prepare.\n   * @param params - The parameters for preparing the call.\n   * @param params.signer - The signer to use for signing the transaction.\n   * @param params.overrides - Optional overrides for the unsigned transaction.\n   * @returns A promise that resolves to the signed transaction.\n   */\n  async prepareCall(\n    runtimeCall: S[\"RuntimeCall\"],\n    { signer, overrides }: CallParams<S>,\n  ): Promise<S[\"Transaction\"]> {\n    const context = {\n      runtimeCall,\n      rollup: this,\n      overrides: overrides ?? ({} as DeepPartial<S[\"UnsignedTransaction\"]>),\n    };\n    const unsignedTx = await this._typeBuilder.unsignedTransaction(context);\n    return this.signTransaction(unsignedTx, signer);\n  }\n\n  /**\n   * Signs an unsigned transaction using the provided signer.\n   * Creates a signature by combining the serialized unsigned transaction with the chain hash,\n   * then constructs a fully signed transaction.\n   *\n   * @param unsignedTx - The unsigned transaction to sign.\n   * @param signer - The signer to use for signing the transaction.\n   * @returns A promise that resolves to the signed transaction.\n   */\n  async signTransaction(\n    unsignedTx: S[\"UnsignedTransaction\"],\n    signer: Signer,\n  ): Promise<S[\"Transaction\"]> {\n    const serializer = await this.serializer();\n    const serializedUnsignedTx = serializer.serializeUnsignedTx(unsignedTx);\n    const chainHash = await this.chainHash();\n    const signature = await signer.sign(\n      new Uint8Array([...serializedUnsignedTx, ...chainHash]),\n    );\n    const publicKey = await signer.publicKey();\n    const context = {\n      unsignedTx,\n      sender: publicKey,\n      signature,\n      rollup: this,\n    };\n    return this._typeBuilder.transaction(context);\n  }\n\n  /**\n   * Create a subscription to events emitted over websockets by the rollup.\n   */\n  subscribe<T extends keyof SubscriptionToCallbackMap>(\n    type: T,\n    callback: SubscriptionToCallbackMap[T],\n  ): Subscription {\n    return createSubscription(type, callback, this.http);\n  }\n\n  /**\n   * Performs a healthcheck against the rollup to determine if it is currently healthy.\n   *\n   * @param timeout - Request timeout in milliseconds.\n   * @returns `true` if the rollup is considered healthy otherwise `false`.\n   */\n  async healthcheck(timeout = 5000): Promise<boolean> {\n    try {\n      await this.http.get(\"/healthcheck\", { timeout, maxRetries: 1 });\n      return true;\n    } catch (e) {\n      return !(e instanceof SovereignClient.APIConnectionError);\n    }\n  }\n\n  /**\n   * A ledger client that can be used to query the ledger.\n   */\n  get ledger(): SovereignClient.Ledger {\n    return this.http.ledger;\n  }\n\n  /**\n   * A sequencer client that can be used to submit transactions & batches to the rollup.\n   */\n  get sequencer(): SovereignClient.Sequencer {\n    return this.http.sequencer;\n  }\n\n  /**\n   * A rollup client that can be used to perform operations on the rollup.\n   */\n  get rollup(): SovereignClient.Rollup {\n    return this.http.rollup;\n  }\n\n  /**\n   * A client that can be used to perform HTTP requests to the Sovereign API.\n   * This can be used as an escape hatch to execute arbitrary requests to the Sovereign API\n   * if the operation is not supported by `ledger`, `sequencer`, or `rollup` clients.\n   */\n  get http(): SovereignClient {\n    return this._config.client;\n  }\n\n  /**\n   * The serializer for the rollup.\n   * Can be used to serialize transactions, runtime calls, etc.\n   */\n  async serializer(): Promise<Serializer> {\n    if (this._serializer) return this._serializer;\n    const { schema } = await this.rollup.schema();\n    this._serializer = this._config.getSerializer(schema);\n    return this._serializer;\n  }\n\n  /**\n   * The context for the rollup.\n   */\n  get context(): C {\n    return this._config.context;\n  }\n\n  async chainHash(): Promise<Uint8Array> {\n    if (this._chainHash) return this._chainHash;\n    const { chain_hash } = await this.rollup.schema();\n    this._chainHash = hexToBytes(chain_hash);\n    return this._chainHash;\n  }\n}\n\nfunction isVersionMismatchError(e: APIError): boolean {\n  if (\n    // biome-ignore lint/suspicious/noExplicitAny: yolo\n    (e.error as any)?.details?.error?.includes(\"Signature verification failed\")\n  ) {\n    return true;\n  }\n\n  return false;\n}\n","/**\n * Base error class for Sovereign SDK Web3.\n */\nexport class SovereignError extends Error {\n  constructor(message: string) {\n    super(message);\n\n    this.name = this.constructor.name;\n    this.stack = new Error().stack;\n  }\n}\n\nexport class InvalidRollupConfigError extends SovereignError {}\n\nexport class VersionMismatchError extends SovereignError {\n  public readonly newVersion: string;\n  public readonly currentVersion: string;\n  public readonly retryable: boolean;\n\n  constructor(message: string, newVersion: string, currentVersion: string) {\n    super(message);\n\n    this.newVersion = newVersion;\n    this.currentVersion = currentVersion;\n    this.retryable = newVersion !== currentVersion;\n  }\n}\n\nexport class SchemaError extends SovereignError {\n  public readonly schema: object;\n  public readonly reason: string;\n\n  constructor(message: string, reason: string, schema: object) {\n    super(`${message}: ${reason}`);\n\n    this.reason = reason;\n    this.schema = schema;\n  }\n}\n","import type SovereignSDK from \"@sovereign-sdk/client\";\nimport IsoWebSocket from \"isomorphic-ws\";\nimport { WebSocket } from \"partysocket\";\nimport { SovereignError } from \"./errors\";\n\ntype Url = string;\n\nexport function httpToWebSocket(url: string) {\n  return url.replace(/^http(s?):\\/\\//, (_, s) => `ws${s}://`);\n}\n\nexport type Subscription = {\n  /** Url providing the subscription. */\n  url: Url;\n  /** Unsubscribe this subscription. */\n  unsubscribe: () => void;\n};\n\ntype SubscriptionEntry = {\n  websocket: WebSocket;\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callbacks: Array<(...args: any[]) => void>;\n};\n\nexport const _subscriptions: Record<Url, SubscriptionEntry> = {};\n\n/** Subscribe to the provided websocket url & call the provided callback on messages received. */\nexport function subscribe(\n  url: Url,\n  // biome-ignore lint/suspicious/noExplicitAny: allow\n  callback: (...args: any[]) => void,\n): Subscription {\n  const subscription = _subscriptions[url];\n\n  if (!subscription) {\n    const websocket = new WebSocket(url, [], { WebSocket: IsoWebSocket });\n    // bun compatibility: https://github.com/partykit/partykit/issues/774\n    websocket.binaryType = \"arraybuffer\";\n\n    _subscriptions[url] = {\n      websocket,\n      callbacks: [callback],\n    };\n\n    websocket.addEventListener(\"message\", (message) => {\n      const data = JSON.parse(message.data);\n      const callbacks = _subscriptions[url]?.callbacks;\n      if (callbacks) {\n        for (const cb of callbacks) {\n          cb(data);\n        }\n      }\n    });\n    websocket.addEventListener(\"error\", (e) =>\n      console.log(\"Websocket error\", e),\n    );\n  } else {\n    subscription.callbacks.push(callback);\n  }\n\n  const callbackIndex = _subscriptions[url]?.callbacks.length - 1;\n\n  return {\n    get url() {\n      return url;\n    },\n    unsubscribe() {\n      const subscription = _subscriptions[url];\n\n      if (!subscription) {\n        return;\n      }\n\n      subscription.callbacks.splice(callbackIndex, 1);\n\n      if (!subscription.callbacks.length) {\n        subscription.websocket.close();\n        delete _subscriptions[url];\n      }\n    },\n  };\n}\n\nexport type EventPayload = {\n  tx_hash: string;\n  type: \"event\";\n  number: number;\n  key: string;\n  value: Record<string, unknown>;\n  module: {\n    type: \"moduleRef\";\n    name: string;\n  };\n};\n\nexport interface SubscriptionToCallbackMap {\n  events: (event: EventPayload) => Promise<void>;\n}\n\nexport function createSubscription<T extends keyof SubscriptionToCallbackMap>(\n  subscription: T,\n  callback: SubscriptionToCallbackMap[T],\n  client: SovereignSDK,\n): Subscription {\n  switch (subscription) {\n    case \"events\": {\n      const url = client.buildURL(\"/sequencer/events/ws\", {});\n      return subscribe(\n        httpToWebSocket(url),\n        callback as SubscriptionToCallbackMap[\"events\"],\n      );\n    }\n    default:\n      throw new SovereignError(`Invalid subscription type '${subscription}'`);\n  }\n}\n","import SovereignClient from \"@sovereign-sdk/client\";\nimport { JsSerializer } from \"@sovereign-sdk/serializers\";\nimport { type HexString, bytesToHex } from \"@sovereign-sdk/utils\";\nimport type { DeepPartial } from \"../utils\";\nimport {\n  Rollup,\n  type RollupConfig,\n  type SignerParams,\n  type TransactionContext,\n  type TypeBuilder,\n  type UnsignedTransactionContext,\n} from \"./rollup\";\n\nexport type TxDetails = {\n  max_priority_fee_bips: number;\n  max_fee: string;\n  gas_limit: number[] | null;\n  chain_id: number;\n};\n\nexport type Generation = { generation: number };\nexport type Nonce = { nonce: number };\nexport type Uniqueness = Nonce | Generation;\n\nexport type UnsignedTransaction<RuntimeCall> = {\n  runtime_call: RuntimeCall;\n  uniqueness: Uniqueness;\n  details: TxDetails;\n};\n\nexport type TransactionV0<RuntimeCall> = {\n  pub_key: HexString;\n  signature: HexString;\n} & UnsignedTransaction<RuntimeCall>;\n\nexport type Transaction<RuntimeCall> = {\n  V0: TransactionV0<RuntimeCall>;\n};\n\nexport type Dedup = {\n  nonce: number;\n};\n\nexport type StandardRollupContext = {\n  defaultTxDetails: TxDetails;\n};\n\nexport type StandardRollupSpec<RuntimeCall> = {\n  UnsignedTransaction: UnsignedTransaction<RuntimeCall>;\n  Transaction: Transaction<RuntimeCall>;\n  RuntimeCall: RuntimeCall;\n  Dedup: Dedup;\n};\n\nconst useOrFetchUniqueness = async <S extends StandardRollupSpec<unknown>>({\n  overrides,\n}: Omit<\n  UnsignedTransactionContext<S, StandardRollupContext>,\n  \"runtimeCall\"\n>) => {\n  if (overrides?.uniqueness) {\n    return overrides.uniqueness;\n  }\n\n  return { generation: Date.now() };\n};\n\nexport function standardTypeBuilder<\n  S extends StandardRollupSpec<unknown>,\n>(): TypeBuilder<S, StandardRollupContext> {\n  return {\n    async unsignedTransaction(\n      context: UnsignedTransactionContext<S, StandardRollupContext>,\n    ) {\n      const { rollup, runtimeCall } = context;\n      const { uniqueness: _, ...overrides } = context.overrides;\n      const uniqueness = await useOrFetchUniqueness(context);\n      const details: TxDetails = {\n        ...rollup.context.defaultTxDetails,\n        ...overrides.details,\n      };\n\n      return {\n        runtime_call: runtimeCall,\n        uniqueness,\n        details,\n      } as S[\"UnsignedTransaction\"];\n    },\n    async transaction({\n      sender,\n      signature,\n      unsignedTx,\n    }: TransactionContext<S, StandardRollupContext>) {\n      return {\n        V0: {\n          pub_key: bytesToHex(sender),\n          signature: bytesToHex(signature),\n          ...unsignedTx,\n        },\n      };\n    },\n  };\n}\n\n/**\n * The parameters for simulating a runtime call transaction.\n */\nexport type SimulateParams = Omit<\n  SovereignClient.RollupSimulateParams,\n  \"call\" | \"sender\"\n> &\n  SignerParams;\n\nexport class StandardRollup<RuntimeCall> extends Rollup<\n  StandardRollupSpec<RuntimeCall>,\n  StandardRollupContext\n> {\n  /**\n   * Simulates a runtime call transaction.\n   *\n   * This method can be useful to estimate the gas cost of a runtime call transaction.\n   *\n   * @param runtimeMessage - The runtime message to call.\n   */\n  async simulate(\n    runtimeMessage: StandardRollupSpec<RuntimeCall>[\"RuntimeCall\"],\n    { signer }: SimulateParams,\n  ): Promise<SovereignClient.Rollup.RollupSimulateResponse> {\n    const publicKey = await signer.publicKey();\n    const sender = bytesToHex(publicKey);\n    const call = runtimeMessage as { [key: string]: unknown };\n\n    return this.rollup.simulate({ sender, call });\n  }\n}\n\nexport const DEFAULT_TX_DETAILS: Omit<TxDetails, \"chain_id\"> = {\n  max_priority_fee_bips: 0,\n  max_fee: \"100000000\",\n  gas_limit: null,\n};\n\nasync function buildContext<C extends StandardRollupContext>(\n  client: SovereignClient,\n  context?: DeepPartial<C>,\n): Promise<C> {\n  const defaultTxDetails = {\n    ...DEFAULT_TX_DETAILS,\n    ...context?.defaultTxDetails,\n  };\n\n  if (!defaultTxDetails.chain_id) {\n    const { chain_id } = await client.rollup.constants();\n\n    defaultTxDetails.chain_id = chain_id;\n  }\n\n  return {\n    defaultTxDetails,\n  } as C;\n}\n\nexport async function createStandardRollup<\n  RuntimeCall,\n  C extends StandardRollupContext = StandardRollupContext,\n>(\n  rollupConfig?: Partial<RollupConfig<DeepPartial<C>>>,\n  typeBuilderOverrides?: Partial<\n    TypeBuilder<StandardRollupSpec<RuntimeCall>, C>\n  >,\n) {\n  const config = rollupConfig ?? {};\n  const client = config.client ?? new SovereignClient({ baseURL: config.url });\n  const getSerializer =\n    config.getSerializer ?? ((schema) => new JsSerializer(schema));\n  const context = await buildContext<C>(client, config.context);\n\n  // Default to the standard transaction submission endpoint\n  const txSubmissionEndpoint = config.txSubmissionEndpoint ?? \"/sequencer/txs\";\n\n  return new StandardRollup<RuntimeCall>(\n    {\n      ...config,\n      client,\n      getSerializer,\n      context,\n      txSubmissionEndpoint,\n    },\n    {\n      ...standardTypeBuilder(),\n      ...typeBuilderOverrides,\n    },\n  );\n}\n","export * from \"./addresses\";\nexport * from \"./rollup\";\nexport * from \"./errors\";\nexport * from \"./type-spec\";\nexport { type EventPayload, Subscription } from \"./subscriptions\";\nexport * as SovereignClient from \"@sovereign-sdk/client\";\n"],"mappings":"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","names":["_a","subscription","SovereignClient","bytesToHex","_a","bytesToHex","SovereignClient","SovereignClient"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovereign-sdk/web3",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "repository": "github:Sovereign-Labs/sovereign-sdk-web3-js",
   "files": [
     "dist",
@@ -24,15 +24,15 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@sovereign-sdk/client": "0.1.0-alpha.36",
+    "@sovereign-sdk/client": "0.1.0-alpha.39",
     "bech32": "^2.0.0",
     "isomorphic-ws": "^5.0.0",
     "js-base64": "^3.7.7",
     "partysocket": "^1.1.3",
     "ws": "^8.18.1",
-    "@sovereign-sdk/signers": "^0.2.1",
-    "@sovereign-sdk/serializers": "^0.1.1",
-    "@sovereign-sdk/universal-wallet-wasm": "^0.4.0",
+    "@sovereign-sdk/signers": "^0.3.0",
+    "@sovereign-sdk/serializers": "^0.1.2",
+    "@sovereign-sdk/universal-wallet-wasm": "^0.5.0",
     "@sovereign-sdk/utils": "^0.0.4"
   },
   "publishConfig": {