@0xsequence/account 1.2.9 → 1.4.0

package/dist/0xsequence-account.cjs.dev.js

@@ -140,8 +140,9 @@ class AccountSigner {
     const finalTransactions = [...prepare.transactions, ...encodeGasRefundTransaction(feeOption)];
     return this.account.sendTransaction(finalTransactions, this.chainId, prepare.feeQuote, undefined, undefined, (_this$options4 = this.options) != null && _this$options4.nonceSpace ? {
       nonceSpace: this.options.nonceSpace
-    } : undefined);
+    } : undefined); // Will always have a transaction response
   }
+
   getBalance(blockTag) {
     return this.provider.getBalance(this.account.address, blockTag);
   }
@@ -209,6 +210,7 @@ class Account {
     this.tracker = options.tracker;
     this.networks = options.networks;
     this.orchestrator = options.orchestrator;
+    this.jwt = options.jwt;
     this.migrations = options.migrations || migration.defaults.DefaultMigrations;
     this.migrator = new migration.migrator.Migrator(options.tracker, this.migrations, this.contexts);
   }
@@ -259,7 +261,7 @@ class Account {
   providerFor(chainId) {
     const found = this.network(chainId);
     if (!found.provider && !found.rpcUrl) throw new Error(`Provider not found for chainId ${chainId}`);
-    return found.provider || new ethers.ethers.providers.StaticJsonRpcProvider(utils.getDefaultConnectionInfo(found.rpcUrl), {
+    return found.provider || new ethers.ethers.providers.StaticJsonRpcProvider(utils.getEthersConnectionInfo(found.rpcUrl, undefined, this.jwt), {
       name: '',
       chainId: ethers.ethers.BigNumber.from(chainId).toNumber()
     });
@@ -275,11 +277,16 @@ class Account {
     const found = this.network(chainId);
     if (!found.relayer) throw new Error(`Relayer not found for chainId ${chainId}`);
     if (relayer.isRelayer(found.relayer)) return found.relayer;
-    return new relayer.RpcRelayer(found.relayer);
+    return new relayer.RpcRelayer(_extends({}, found.relayer, {
+      jwtAuth: this.jwt
+    }));
   }
   setOrchestrator(orchestrator) {
     this.orchestrator = orchestrator;
   }
+  setJwt(jwt) {
+    this.jwt = jwt;
+  }
   contextFor(version) {
     const ctx = this.contexts[version];
     if (!ctx) throw new Error(`Context not found for version ${version}`);
@@ -410,6 +417,19 @@ class Account {
       throw new Error(`Wallet ${this.address} is not fully migrated`);
     }
   }
+  async predecorateSignedTransactions(status, chainId) {
+    // Request signed predecorate transactions from child wallets
+    const bundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    // Get signed predecorate transaction
+    const predecorated = await this.predecorateTransactions([], status, chainId);
+    if (core.commons.transaction.fromTransactionish(this.address, predecorated).length > 0) {
+      // Sign it
+      bundles.push(await this.signTransactions(predecorated, chainId));
+    }
+    return bundles;
+  }
   async predecorateTransactions(txs, status, chainId) {
     // if onchain wallet config is not up to date
     // then we should append an extra transaction that updates it
@@ -421,34 +441,49 @@ class Account {
     }
     return txs;
   }
-  decorateTransactions(bundle, status) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, bundle.chainId);
-    if (bootstrapBundle.transactions.length === 0) {
-      return bundle;
+  async decorateTransactions(bundles, status, chainId) {
+    var _chainId;
+    if (!Array.isArray(bundles)) {
+      // Recurse with array
+      return this.decorateTransactions([bundles], status, chainId);
+    }
+
+    // Default to chainId of first bundle when not supplied
+    chainId = (_chainId = chainId) != null ? _chainId : bundles[0].chainId;
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
+    const hasBootstrapTxs = bootstrapBundle.transactions.length > 0;
+    if (!hasBootstrapTxs && bundles.length === 1) {
+      return bundles[0];
     }
+
+    // Intent defaults to first bundle when no bootstrap transaction
+    const {
+      entrypoint
+    } = hasBootstrapTxs ? bootstrapBundle : bundles[0];
     const decoratedBundle = {
-      entrypoint: bootstrapBundle.entrypoint,
-      chainId: bundle.chainId,
-      intent: bundle.intent,
-      transactions: [...bootstrapBundle.transactions, {
+      entrypoint,
+      chainId,
+      // Intent of the first bundle is used
+      intent: bundles[0].intent,
+      transactions: [...bootstrapBundle.transactions, ...bundles.map(bundle => ({
         to: bundle.entrypoint,
         data: core.commons.transaction.encodeBundleExecData(bundle),
         gasLimit: 0,
         delegateCall: false,
         revertOnError: true,
         value: 0
-      }]
+      }))]
     };
 
     // Re-compute the meta-transaction id to use the guest module subdigest
     if (!status.onChain.deployed) {
-      decoratedBundle.intent.id = core.commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, decoratedBundle.chainId, decoratedBundle.transactions);
+      decoratedBundle.intent.id = core.commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, chainId, decoratedBundle.transactions);
     }
     return decoratedBundle;
   }
-  decorateSignature(signature, status) {
+  async decorateSignature(signature, status) {
     if (!status.presignedConfigurations || status.presignedConfigurations.length === 0) {
-      return new Promise(resolve => resolve(signature));
+      return signature;
     }
     const coder = this.coders.signature;
     const chain = status.presignedConfigurations.map(c => c.signature);
@@ -467,14 +502,13 @@ class Account {
       signatures
     });
   }
-  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore') {
+  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore', metadata) {
     // If we are signing a digest for chainId zero then we can never be fully migrated
     // because Sequence v1 doesn't allow for signing a message on "all chains"
 
     // So we ignore the state on "chain zero" and instead use one of the states of the networks
     // wallet-webapp should ensure the wallet is as migrated as possible, trying to mimic
     // the behaviour of being migrated on all chains
-
     const chainRef = ethers.ethers.constants.Zero.eq(chainId) ? this.networks[0].chainId : chainId;
     const status = await this.status(chainRef);
     this.mustBeFullyMigrated(status);
@@ -485,7 +519,7 @@ class Account {
       throw new Error('Wallet cannot validate onchain');
     }
     const wallet = this.walletForStatus(chainId, status);
-    const signature = await wallet.signDigest(digest);
+    const signature = await wallet.signDigest(digest, metadata);
     const decorated = decorate ? this.decorateSignature(signature, status) : signature;
 
     // If the wallet can't validate onchain then we
@@ -504,8 +538,8 @@ class Account {
     }
     return decorated;
   }
-  buildEIP6492Signature(signature, status, chainId) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, chainId);
+  async buildEIP6492Signature(signature, status, chainId) {
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
     if (bootstrapBundle.transactions.length === 0) {
       throw new Error('Cannot build EIP-6492 signature without bootstrap transactions');
     }
@@ -561,8 +595,12 @@ class Account {
    *  by any of the migrations.
    *
    */
-  buildBootstrapTransactions(status, chainId) {
-    const transactions = [];
+  async buildBootstrapTransactions(status, chainId) {
+    var _bundle$transactions;
+    const bundle = await this.orchestrator.buildDeployTransaction({
+      chainId
+    });
+    const transactions = (_bundle$transactions = bundle == null ? void 0 : bundle.transactions) != null ? _bundle$transactions : [];
 
     // Add wallet deployment if needed
     if (!status.onChain.deployed) {
@@ -571,6 +609,7 @@ class Account {
       const deployTransaction = wallet.Wallet.buildDeployTransaction(status.original.context, status.original.imageHash);
       transactions.push(...deployTransaction.transactions);
     }
+    transactions.length;
 
     // Get pending migrations
     transactions.push(...status.signedMigrations.map(m => ({
@@ -620,9 +659,20 @@ class Account {
     const status = pstatus || (await this.status(chainId));
     this.mustBeFullyMigrated(status);
     const wallet = this.walletForStatus(chainId, status);
+    const metadata = {
+      address: this.address,
+      digest: '',
+      // Set in wallet.signTransactions
+      chainId,
+      config: {
+        version: this.version
+      },
+      decorate: true,
+      cantValidateBehavior: 'ignore'
+    };
     const signed = await wallet.signTransactions(txs, (options == null ? void 0 : options.nonceSpace) && {
       space: options == null ? void 0 : options.nonceSpace
-    });
+    }, metadata);
     return _extends({}, signed, {
       signature: await this.decorateSignature(signed.signature, status)
     });
@@ -701,9 +751,12 @@ class Account {
     };
   }
   async sendSignedTransactions(signedBundle, chainId, quote, pstatus, callback) {
-    const status = pstatus || (await this.status(signedBundle.chainId));
+    if (!Array.isArray(signedBundle)) {
+      return this.sendSignedTransactions([signedBundle], chainId, quote, pstatus, callback);
+    }
+    const status = pstatus || (await this.status(signedBundle[0].chainId));
     this.mustBeFullyMigrated(status);
-    const decoratedBundle = this.decorateTransactions(signedBundle, status);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, status);
     callback == null ? void 0 : callback(decoratedBundle);
     return this.relayer(chainId).relay(decoratedBundle, quote);
   }
@@ -736,7 +789,7 @@ class Account {
       nonce: 0 // The relayer also ignored the nonce
     };
 
-    const decoratedBundle = this.decorateTransactions(signedBundle, wstatus);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, wstatus);
     const data = core.commons.transaction.encodeBundleExecData(decoratedBundle);
     const res = await this.relayer(chainId).getFeeOptionsRaw(decoratedBundle.entrypoint, data, options);
     return _extends({}, res, {
@@ -760,9 +813,21 @@ class Account {
   async sendTransaction(txs, chainId, quote, skipPreDecorate = false, callback, options) {
     const status = await this.status(chainId);
     const predecorated = skipPreDecorate ? txs : await this.predecorateTransactions(txs, status, chainId);
-    const signed = await this.signTransactions(predecorated, chainId, undefined, options);
-    // TODO: is it safe to pass status again here?
-    return this.sendSignedTransactions(signed, chainId, quote, undefined, callback);
+    const hasTxs = core.commons.transaction.fromTransactionish(this.address, predecorated).length > 0;
+    const signed = hasTxs ? await this.signTransactions(predecorated, chainId, undefined, options) : undefined;
+    const childBundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    const bundles = [];
+    if (signed !== undefined && signed.transactions.length > 0) {
+      bundles.push(signed);
+    }
+    bundles.push(...childBundles.filter(b => b.transactions.length > 0));
+    if (bundles.length === 0) {
+      // Nothing to send?
+      return;
+    }
+    return this.sendSignedTransactions(bundles, chainId, quote, undefined, callback);
   }
   async signTypedData(domain, types, message, chainId, cantValidateBehavior = 'ignore') {
     const digest = utils.encodeTypedDataDigest({

package/dist/0xsequence-account.cjs.prod.js

@@ -140,8 +140,9 @@ class AccountSigner {
     const finalTransactions = [...prepare.transactions, ...encodeGasRefundTransaction(feeOption)];
     return this.account.sendTransaction(finalTransactions, this.chainId, prepare.feeQuote, undefined, undefined, (_this$options4 = this.options) != null && _this$options4.nonceSpace ? {
       nonceSpace: this.options.nonceSpace
-    } : undefined);
+    } : undefined); // Will always have a transaction response
   }
+
   getBalance(blockTag) {
     return this.provider.getBalance(this.account.address, blockTag);
   }
@@ -209,6 +210,7 @@ class Account {
     this.tracker = options.tracker;
     this.networks = options.networks;
     this.orchestrator = options.orchestrator;
+    this.jwt = options.jwt;
     this.migrations = options.migrations || migration.defaults.DefaultMigrations;
     this.migrator = new migration.migrator.Migrator(options.tracker, this.migrations, this.contexts);
   }
@@ -259,7 +261,7 @@ class Account {
   providerFor(chainId) {
     const found = this.network(chainId);
     if (!found.provider && !found.rpcUrl) throw new Error(`Provider not found for chainId ${chainId}`);
-    return found.provider || new ethers.ethers.providers.StaticJsonRpcProvider(utils.getDefaultConnectionInfo(found.rpcUrl), {
+    return found.provider || new ethers.ethers.providers.StaticJsonRpcProvider(utils.getEthersConnectionInfo(found.rpcUrl, undefined, this.jwt), {
       name: '',
       chainId: ethers.ethers.BigNumber.from(chainId).toNumber()
     });
@@ -275,11 +277,16 @@ class Account {
     const found = this.network(chainId);
     if (!found.relayer) throw new Error(`Relayer not found for chainId ${chainId}`);
     if (relayer.isRelayer(found.relayer)) return found.relayer;
-    return new relayer.RpcRelayer(found.relayer);
+    return new relayer.RpcRelayer(_extends({}, found.relayer, {
+      jwtAuth: this.jwt
+    }));
   }
   setOrchestrator(orchestrator) {
     this.orchestrator = orchestrator;
   }
+  setJwt(jwt) {
+    this.jwt = jwt;
+  }
   contextFor(version) {
     const ctx = this.contexts[version];
     if (!ctx) throw new Error(`Context not found for version ${version}`);
@@ -410,6 +417,19 @@ class Account {
       throw new Error(`Wallet ${this.address} is not fully migrated`);
     }
   }
+  async predecorateSignedTransactions(status, chainId) {
+    // Request signed predecorate transactions from child wallets
+    const bundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    // Get signed predecorate transaction
+    const predecorated = await this.predecorateTransactions([], status, chainId);
+    if (core.commons.transaction.fromTransactionish(this.address, predecorated).length > 0) {
+      // Sign it
+      bundles.push(await this.signTransactions(predecorated, chainId));
+    }
+    return bundles;
+  }
   async predecorateTransactions(txs, status, chainId) {
     // if onchain wallet config is not up to date
     // then we should append an extra transaction that updates it
@@ -421,34 +441,49 @@ class Account {
     }
     return txs;
   }
-  decorateTransactions(bundle, status) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, bundle.chainId);
-    if (bootstrapBundle.transactions.length === 0) {
-      return bundle;
+  async decorateTransactions(bundles, status, chainId) {
+    var _chainId;
+    if (!Array.isArray(bundles)) {
+      // Recurse with array
+      return this.decorateTransactions([bundles], status, chainId);
+    }
+
+    // Default to chainId of first bundle when not supplied
+    chainId = (_chainId = chainId) != null ? _chainId : bundles[0].chainId;
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
+    const hasBootstrapTxs = bootstrapBundle.transactions.length > 0;
+    if (!hasBootstrapTxs && bundles.length === 1) {
+      return bundles[0];
     }
+
+    // Intent defaults to first bundle when no bootstrap transaction
+    const {
+      entrypoint
+    } = hasBootstrapTxs ? bootstrapBundle : bundles[0];
     const decoratedBundle = {
-      entrypoint: bootstrapBundle.entrypoint,
-      chainId: bundle.chainId,
-      intent: bundle.intent,
-      transactions: [...bootstrapBundle.transactions, {
+      entrypoint,
+      chainId,
+      // Intent of the first bundle is used
+      intent: bundles[0].intent,
+      transactions: [...bootstrapBundle.transactions, ...bundles.map(bundle => ({
         to: bundle.entrypoint,
         data: core.commons.transaction.encodeBundleExecData(bundle),
         gasLimit: 0,
         delegateCall: false,
         revertOnError: true,
         value: 0
-      }]
+      }))]
     };
 
     // Re-compute the meta-transaction id to use the guest module subdigest
     if (!status.onChain.deployed) {
-      decoratedBundle.intent.id = core.commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, decoratedBundle.chainId, decoratedBundle.transactions);
+      decoratedBundle.intent.id = core.commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, chainId, decoratedBundle.transactions);
     }
     return decoratedBundle;
   }
-  decorateSignature(signature, status) {
+  async decorateSignature(signature, status) {
     if (!status.presignedConfigurations || status.presignedConfigurations.length === 0) {
-      return new Promise(resolve => resolve(signature));
+      return signature;
     }
     const coder = this.coders.signature;
     const chain = status.presignedConfigurations.map(c => c.signature);
@@ -467,14 +502,13 @@ class Account {
       signatures
     });
   }
-  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore') {
+  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore', metadata) {
     // If we are signing a digest for chainId zero then we can never be fully migrated
     // because Sequence v1 doesn't allow for signing a message on "all chains"
 
     // So we ignore the state on "chain zero" and instead use one of the states of the networks
     // wallet-webapp should ensure the wallet is as migrated as possible, trying to mimic
     // the behaviour of being migrated on all chains
-
     const chainRef = ethers.ethers.constants.Zero.eq(chainId) ? this.networks[0].chainId : chainId;
     const status = await this.status(chainRef);
     this.mustBeFullyMigrated(status);
@@ -485,7 +519,7 @@ class Account {
       throw new Error('Wallet cannot validate onchain');
     }
     const wallet = this.walletForStatus(chainId, status);
-    const signature = await wallet.signDigest(digest);
+    const signature = await wallet.signDigest(digest, metadata);
     const decorated = decorate ? this.decorateSignature(signature, status) : signature;
 
     // If the wallet can't validate onchain then we
@@ -504,8 +538,8 @@ class Account {
     }
     return decorated;
   }
-  buildEIP6492Signature(signature, status, chainId) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, chainId);
+  async buildEIP6492Signature(signature, status, chainId) {
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
     if (bootstrapBundle.transactions.length === 0) {
       throw new Error('Cannot build EIP-6492 signature without bootstrap transactions');
     }
@@ -561,8 +595,12 @@ class Account {
    *  by any of the migrations.
    *
    */
-  buildBootstrapTransactions(status, chainId) {
-    const transactions = [];
+  async buildBootstrapTransactions(status, chainId) {
+    var _bundle$transactions;
+    const bundle = await this.orchestrator.buildDeployTransaction({
+      chainId
+    });
+    const transactions = (_bundle$transactions = bundle == null ? void 0 : bundle.transactions) != null ? _bundle$transactions : [];
 
     // Add wallet deployment if needed
     if (!status.onChain.deployed) {
@@ -571,6 +609,7 @@ class Account {
       const deployTransaction = wallet.Wallet.buildDeployTransaction(status.original.context, status.original.imageHash);
       transactions.push(...deployTransaction.transactions);
     }
+    transactions.length;
 
     // Get pending migrations
     transactions.push(...status.signedMigrations.map(m => ({
@@ -620,9 +659,20 @@ class Account {
     const status = pstatus || (await this.status(chainId));
     this.mustBeFullyMigrated(status);
     const wallet = this.walletForStatus(chainId, status);
+    const metadata = {
+      address: this.address,
+      digest: '',
+      // Set in wallet.signTransactions
+      chainId,
+      config: {
+        version: this.version
+      },
+      decorate: true,
+      cantValidateBehavior: 'ignore'
+    };
     const signed = await wallet.signTransactions(txs, (options == null ? void 0 : options.nonceSpace) && {
       space: options == null ? void 0 : options.nonceSpace
-    });
+    }, metadata);
     return _extends({}, signed, {
       signature: await this.decorateSignature(signed.signature, status)
     });
@@ -701,9 +751,12 @@ class Account {
     };
   }
   async sendSignedTransactions(signedBundle, chainId, quote, pstatus, callback) {
-    const status = pstatus || (await this.status(signedBundle.chainId));
+    if (!Array.isArray(signedBundle)) {
+      return this.sendSignedTransactions([signedBundle], chainId, quote, pstatus, callback);
+    }
+    const status = pstatus || (await this.status(signedBundle[0].chainId));
     this.mustBeFullyMigrated(status);
-    const decoratedBundle = this.decorateTransactions(signedBundle, status);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, status);
     callback == null ? void 0 : callback(decoratedBundle);
     return this.relayer(chainId).relay(decoratedBundle, quote);
   }
@@ -736,7 +789,7 @@ class Account {
       nonce: 0 // The relayer also ignored the nonce
     };
 
-    const decoratedBundle = this.decorateTransactions(signedBundle, wstatus);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, wstatus);
     const data = core.commons.transaction.encodeBundleExecData(decoratedBundle);
     const res = await this.relayer(chainId).getFeeOptionsRaw(decoratedBundle.entrypoint, data, options);
     return _extends({}, res, {
@@ -760,9 +813,21 @@ class Account {
   async sendTransaction(txs, chainId, quote, skipPreDecorate = false, callback, options) {
     const status = await this.status(chainId);
     const predecorated = skipPreDecorate ? txs : await this.predecorateTransactions(txs, status, chainId);
-    const signed = await this.signTransactions(predecorated, chainId, undefined, options);
-    // TODO: is it safe to pass status again here?
-    return this.sendSignedTransactions(signed, chainId, quote, undefined, callback);
+    const hasTxs = core.commons.transaction.fromTransactionish(this.address, predecorated).length > 0;
+    const signed = hasTxs ? await this.signTransactions(predecorated, chainId, undefined, options) : undefined;
+    const childBundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    const bundles = [];
+    if (signed !== undefined && signed.transactions.length > 0) {
+      bundles.push(signed);
+    }
+    bundles.push(...childBundles.filter(b => b.transactions.length > 0));
+    if (bundles.length === 0) {
+      // Nothing to send?
+      return;
+    }
+    return this.sendSignedTransactions(bundles, chainId, quote, undefined, callback);
   }
   async signTypedData(domain, types, message, chainId, cantValidateBehavior = 'ignore') {
     const digest = utils.encodeTypedDataDigest({

package/dist/0xsequence-account.esm.js

@@ -1,7 +1,7 @@
 import { commons, universal } from '@0xsequence/core';
 import { defaults, migrator, version } from '@0xsequence/migration';
 import { proto, isRelayer, RpcRelayer } from '@0xsequence/relayer';
-import { getDefaultConnectionInfo, encodeTypedDataDigest } from '@0xsequence/utils';
+import { getEthersConnectionInfo, encodeTypedDataDigest } from '@0xsequence/utils';
 import { Wallet } from '@0xsequence/wallet';
 import { ethers } from 'ethers';
 
@@ -136,8 +136,9 @@ class AccountSigner {
     const finalTransactions = [...prepare.transactions, ...encodeGasRefundTransaction(feeOption)];
     return this.account.sendTransaction(finalTransactions, this.chainId, prepare.feeQuote, undefined, undefined, (_this$options4 = this.options) != null && _this$options4.nonceSpace ? {
       nonceSpace: this.options.nonceSpace
-    } : undefined);
+    } : undefined); // Will always have a transaction response
   }
+
   getBalance(blockTag) {
     return this.provider.getBalance(this.account.address, blockTag);
   }
@@ -205,6 +206,7 @@ class Account {
     this.tracker = options.tracker;
     this.networks = options.networks;
     this.orchestrator = options.orchestrator;
+    this.jwt = options.jwt;
     this.migrations = options.migrations || defaults.DefaultMigrations;
     this.migrator = new migrator.Migrator(options.tracker, this.migrations, this.contexts);
   }
@@ -255,7 +257,7 @@ class Account {
   providerFor(chainId) {
     const found = this.network(chainId);
     if (!found.provider && !found.rpcUrl) throw new Error(`Provider not found for chainId ${chainId}`);
-    return found.provider || new ethers.providers.StaticJsonRpcProvider(getDefaultConnectionInfo(found.rpcUrl), {
+    return found.provider || new ethers.providers.StaticJsonRpcProvider(getEthersConnectionInfo(found.rpcUrl, undefined, this.jwt), {
       name: '',
       chainId: ethers.BigNumber.from(chainId).toNumber()
     });
@@ -271,11 +273,16 @@ class Account {
     const found = this.network(chainId);
     if (!found.relayer) throw new Error(`Relayer not found for chainId ${chainId}`);
     if (isRelayer(found.relayer)) return found.relayer;
-    return new RpcRelayer(found.relayer);
+    return new RpcRelayer(_extends({}, found.relayer, {
+      jwtAuth: this.jwt
+    }));
   }
   setOrchestrator(orchestrator) {
     this.orchestrator = orchestrator;
   }
+  setJwt(jwt) {
+    this.jwt = jwt;
+  }
   contextFor(version) {
     const ctx = this.contexts[version];
     if (!ctx) throw new Error(`Context not found for version ${version}`);
@@ -406,6 +413,19 @@ class Account {
       throw new Error(`Wallet ${this.address} is not fully migrated`);
     }
   }
+  async predecorateSignedTransactions(status, chainId) {
+    // Request signed predecorate transactions from child wallets
+    const bundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    // Get signed predecorate transaction
+    const predecorated = await this.predecorateTransactions([], status, chainId);
+    if (commons.transaction.fromTransactionish(this.address, predecorated).length > 0) {
+      // Sign it
+      bundles.push(await this.signTransactions(predecorated, chainId));
+    }
+    return bundles;
+  }
   async predecorateTransactions(txs, status, chainId) {
     // if onchain wallet config is not up to date
     // then we should append an extra transaction that updates it
@@ -417,34 +437,49 @@ class Account {
     }
     return txs;
   }
-  decorateTransactions(bundle, status) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, bundle.chainId);
-    if (bootstrapBundle.transactions.length === 0) {
-      return bundle;
+  async decorateTransactions(bundles, status, chainId) {
+    var _chainId;
+    if (!Array.isArray(bundles)) {
+      // Recurse with array
+      return this.decorateTransactions([bundles], status, chainId);
+    }
+
+    // Default to chainId of first bundle when not supplied
+    chainId = (_chainId = chainId) != null ? _chainId : bundles[0].chainId;
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
+    const hasBootstrapTxs = bootstrapBundle.transactions.length > 0;
+    if (!hasBootstrapTxs && bundles.length === 1) {
+      return bundles[0];
     }
+
+    // Intent defaults to first bundle when no bootstrap transaction
+    const {
+      entrypoint
+    } = hasBootstrapTxs ? bootstrapBundle : bundles[0];
     const decoratedBundle = {
-      entrypoint: bootstrapBundle.entrypoint,
-      chainId: bundle.chainId,
-      intent: bundle.intent,
-      transactions: [...bootstrapBundle.transactions, {
+      entrypoint,
+      chainId,
+      // Intent of the first bundle is used
+      intent: bundles[0].intent,
+      transactions: [...bootstrapBundle.transactions, ...bundles.map(bundle => ({
         to: bundle.entrypoint,
         data: commons.transaction.encodeBundleExecData(bundle),
         gasLimit: 0,
         delegateCall: false,
         revertOnError: true,
         value: 0
-      }]
+      }))]
     };
 
     // Re-compute the meta-transaction id to use the guest module subdigest
     if (!status.onChain.deployed) {
-      decoratedBundle.intent.id = commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, decoratedBundle.chainId, decoratedBundle.transactions);
+      decoratedBundle.intent.id = commons.transaction.subdigestOfGuestModuleTransactions(this.contexts[this.version].guestModule, chainId, decoratedBundle.transactions);
     }
     return decoratedBundle;
   }
-  decorateSignature(signature, status) {
+  async decorateSignature(signature, status) {
     if (!status.presignedConfigurations || status.presignedConfigurations.length === 0) {
-      return new Promise(resolve => resolve(signature));
+      return signature;
     }
     const coder = this.coders.signature;
     const chain = status.presignedConfigurations.map(c => c.signature);
@@ -463,14 +498,13 @@ class Account {
       signatures
     });
   }
-  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore') {
+  async signDigest(digest, chainId, decorate = true, cantValidateBehavior = 'ignore', metadata) {
     // If we are signing a digest for chainId zero then we can never be fully migrated
     // because Sequence v1 doesn't allow for signing a message on "all chains"
 
     // So we ignore the state on "chain zero" and instead use one of the states of the networks
     // wallet-webapp should ensure the wallet is as migrated as possible, trying to mimic
     // the behaviour of being migrated on all chains
-
     const chainRef = ethers.constants.Zero.eq(chainId) ? this.networks[0].chainId : chainId;
     const status = await this.status(chainRef);
     this.mustBeFullyMigrated(status);
@@ -481,7 +515,7 @@ class Account {
       throw new Error('Wallet cannot validate onchain');
     }
     const wallet = this.walletForStatus(chainId, status);
-    const signature = await wallet.signDigest(digest);
+    const signature = await wallet.signDigest(digest, metadata);
     const decorated = decorate ? this.decorateSignature(signature, status) : signature;
 
     // If the wallet can't validate onchain then we
@@ -500,8 +534,8 @@ class Account {
     }
     return decorated;
   }
-  buildEIP6492Signature(signature, status, chainId) {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, chainId);
+  async buildEIP6492Signature(signature, status, chainId) {
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId);
     if (bootstrapBundle.transactions.length === 0) {
       throw new Error('Cannot build EIP-6492 signature without bootstrap transactions');
     }
@@ -557,8 +591,12 @@ class Account {
    *  by any of the migrations.
    *
    */
-  buildBootstrapTransactions(status, chainId) {
-    const transactions = [];
+  async buildBootstrapTransactions(status, chainId) {
+    var _bundle$transactions;
+    const bundle = await this.orchestrator.buildDeployTransaction({
+      chainId
+    });
+    const transactions = (_bundle$transactions = bundle == null ? void 0 : bundle.transactions) != null ? _bundle$transactions : [];
 
     // Add wallet deployment if needed
     if (!status.onChain.deployed) {
@@ -567,6 +605,7 @@ class Account {
       const deployTransaction = Wallet.buildDeployTransaction(status.original.context, status.original.imageHash);
       transactions.push(...deployTransaction.transactions);
     }
+    transactions.length;
 
     // Get pending migrations
     transactions.push(...status.signedMigrations.map(m => ({
@@ -616,9 +655,20 @@ class Account {
     const status = pstatus || (await this.status(chainId));
     this.mustBeFullyMigrated(status);
     const wallet = this.walletForStatus(chainId, status);
+    const metadata = {
+      address: this.address,
+      digest: '',
+      // Set in wallet.signTransactions
+      chainId,
+      config: {
+        version: this.version
+      },
+      decorate: true,
+      cantValidateBehavior: 'ignore'
+    };
     const signed = await wallet.signTransactions(txs, (options == null ? void 0 : options.nonceSpace) && {
       space: options == null ? void 0 : options.nonceSpace
-    });
+    }, metadata);
     return _extends({}, signed, {
       signature: await this.decorateSignature(signed.signature, status)
     });
@@ -697,9 +747,12 @@ class Account {
     };
   }
   async sendSignedTransactions(signedBundle, chainId, quote, pstatus, callback) {
-    const status = pstatus || (await this.status(signedBundle.chainId));
+    if (!Array.isArray(signedBundle)) {
+      return this.sendSignedTransactions([signedBundle], chainId, quote, pstatus, callback);
+    }
+    const status = pstatus || (await this.status(signedBundle[0].chainId));
     this.mustBeFullyMigrated(status);
-    const decoratedBundle = this.decorateTransactions(signedBundle, status);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, status);
     callback == null ? void 0 : callback(decoratedBundle);
     return this.relayer(chainId).relay(decoratedBundle, quote);
   }
@@ -732,7 +785,7 @@ class Account {
       nonce: 0 // The relayer also ignored the nonce
     };
 
-    const decoratedBundle = this.decorateTransactions(signedBundle, wstatus);
+    const decoratedBundle = await this.decorateTransactions(signedBundle, wstatus);
     const data = commons.transaction.encodeBundleExecData(decoratedBundle);
     const res = await this.relayer(chainId).getFeeOptionsRaw(decoratedBundle.entrypoint, data, options);
     return _extends({}, res, {
@@ -756,9 +809,21 @@ class Account {
   async sendTransaction(txs, chainId, quote, skipPreDecorate = false, callback, options) {
     const status = await this.status(chainId);
     const predecorated = skipPreDecorate ? txs : await this.predecorateTransactions(txs, status, chainId);
-    const signed = await this.signTransactions(predecorated, chainId, undefined, options);
-    // TODO: is it safe to pass status again here?
-    return this.sendSignedTransactions(signed, chainId, quote, undefined, callback);
+    const hasTxs = commons.transaction.fromTransactionish(this.address, predecorated).length > 0;
+    const signed = hasTxs ? await this.signTransactions(predecorated, chainId, undefined, options) : undefined;
+    const childBundles = await this.orchestrator.predecorateSignedTransactions({
+      chainId
+    });
+    const bundles = [];
+    if (signed !== undefined && signed.transactions.length > 0) {
+      bundles.push(signed);
+    }
+    bundles.push(...childBundles.filter(b => b.transactions.length > 0));
+    if (bundles.length === 0) {
+      // Nothing to send?
+      return;
+    }
+    return this.sendSignedTransactions(bundles, chainId, quote, undefined, callback);
   }
   async signTypedData(domain, types, message, chainId, cantValidateBehavior = 'ignore') {
     const digest = encodeTypedDataDigest({

package/dist/declarations/src/account.d.ts

@@ -35,6 +35,7 @@ export type AccountOptions = {
     migrations?: migrator.Migrations;
     orchestrator: Orchestrator;
     networks: NetworkConfig[];
+    jwt?: string;
 };
 export interface PreparedTransactions {
     transactions: commons.transaction.SimulatedTransaction[];
@@ -50,6 +51,7 @@ export declare class Account {
     readonly migrator: migrator.Migrator;
     readonly migrations: migrator.Migrations;
     private orchestrator;
+    private jwt?;
     constructor(options: AccountOptions);
     getSigner(chainId: ChainId, options?: AccountSignerOptions): AccountSigner;
     static new(options: {
@@ -71,16 +73,18 @@ export declare class Account {
     reader(chainId: ethers.BigNumberish): commons.reader.Reader;
     relayer(chainId: ethers.BigNumberish): Relayer;
     setOrchestrator(orchestrator: Orchestrator): void;
+    setJwt(jwt: string): void;
     contextFor(version: number): commons.context.WalletContext;
     walletForStatus(chainId: ethers.BigNumberish, status: Pick<AccountStatus, 'version'> & Pick<AccountStatus, 'config'>): Wallet;
     walletFor(chainId: ethers.BigNumberish, context: commons.context.WalletContext, config: commons.config.Config, coders: typeof this.coders): Wallet;
     status(chainId: ethers.BigNumberish, longestPath?: boolean): Promise<AccountStatus>;
     private mustBeFullyMigrated;
+    predecorateSignedTransactions(status: AccountStatus, chainId: ethers.BigNumberish): Promise<commons.transaction.SignedTransactionBundle[]>;
     predecorateTransactions(txs: commons.transaction.Transactionish, status: AccountStatus, chainId: ethers.BigNumberish): Promise<commons.transaction.Transactionish>;
-    decorateTransactions(bundle: commons.transaction.IntendedTransactionBundle, status: AccountStatus): commons.transaction.IntendedTransactionBundle;
+    decorateTransactions(bundles: commons.transaction.IntendedTransactionBundle | commons.transaction.IntendedTransactionBundle[], status: AccountStatus, chainId?: ethers.BigNumberish): Promise<commons.transaction.IntendedTransactionBundle>;
     decorateSignature<T extends ethers.BytesLike>(signature: T, status: Partial<Pick<AccountStatus, 'presignedConfigurations'>>): Promise<T | string>;
     publishWitness(): Promise<void>;
-    signDigest(digest: ethers.BytesLike, chainId: ethers.BigNumberish, decorate?: boolean, cantValidateBehavior?: 'ignore' | 'eip6492' | 'throw'): Promise<string>;
+    signDigest(digest: ethers.BytesLike, chainId: ethers.BigNumberish, decorate?: boolean, cantValidateBehavior?: 'ignore' | 'eip6492' | 'throw', metadata?: object): Promise<string>;
     private buildEIP6492Signature;
     editConfig(changes: {
         add?: commons.config.SimpleSigner[];
@@ -99,7 +103,7 @@ export declare class Account {
      *  by any of the migrations.
      *
      */
-    buildBootstrapTransactions(status: AccountStatus, chainId: ethers.BigNumberish): commons.transaction.IntendedTransactionBundle;
+    buildBootstrapTransactions(status: AccountStatus, chainId: ethers.BigNumberish): Promise<commons.transaction.IntendedTransactionBundle>;
     bootstrapTransactions(chainId: ethers.BigNumberish, prestatus?: AccountStatus): Promise<Omit<commons.transaction.IntendedTransactionBundle, 'chainId'>>;
     doBootstrap(chainId: ethers.BigNumberish, feeQuote?: FeeQuote, prestatus?: AccountStatus): Promise<commons.transaction.TransactionResponse<any>>;
     signMessage(message: ethers.BytesLike, chainId: ethers.BigNumberish, cantValidateBehavior?: 'ignore' | 'eip6492' | 'throw'): Promise<string>;
@@ -115,7 +119,7 @@ export declare class Account {
         migratedAllChains: boolean;
         failedChains: number[];
     }>;
-    sendSignedTransactions(signedBundle: commons.transaction.IntendedTransactionBundle, chainId: ethers.BigNumberish, quote?: FeeQuote, pstatus?: AccountStatus, callback?: (bundle: commons.transaction.IntendedTransactionBundle) => void): Promise<ethers.providers.TransactionResponse>;
+    sendSignedTransactions(signedBundle: commons.transaction.IntendedTransactionBundle | commons.transaction.IntendedTransactionBundle[], chainId: ethers.BigNumberish, quote?: FeeQuote, pstatus?: AccountStatus, callback?: (bundle: commons.transaction.IntendedTransactionBundle) => void): Promise<ethers.providers.TransactionResponse>;
     fillGasLimits(txs: commons.transaction.Transactionish, chainId: ethers.BigNumberish, status?: AccountStatus): Promise<commons.transaction.SimulatedTransaction[]>;
     gasRefundQuotes(txs: commons.transaction.Transactionish, chainId: ethers.BigNumberish, stubSignatureOverrides: Map<string, string>, status?: AccountStatus, options?: {
         simulate?: boolean;
@@ -132,7 +136,7 @@ export declare class Account {
     }): Promise<PreparedTransactions>;
     sendTransaction(txs: commons.transaction.Transactionish, chainId: ethers.BigNumberish, quote?: FeeQuote, skipPreDecorate?: boolean, callback?: (bundle: commons.transaction.IntendedTransactionBundle) => void, options?: {
         nonceSpace?: ethers.BigNumberish;
-    }): Promise<ethers.providers.TransactionResponse>;
+    }): Promise<ethers.providers.TransactionResponse | undefined>;
     signTypedData(domain: TypedDataDomain, types: Record<string, Array<TypedDataField>>, message: Record<string, any>, chainId: ethers.BigNumberish, cantValidateBehavior?: 'ignore' | 'eip6492' | 'throw'): Promise<string>;
     getAllSigners(): Promise<{
         address: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xsequence/account",
-  "version": "1.2.9",
+  "version": "1.4.0",
   "description": "tools for migrating sequence wallets to new versions",
   "repository": "https://github.com/0xsequence/sequence.js/tree/master/packages/account",
   "source": "src/index.ts",
@@ -10,19 +10,19 @@
   "license": "Apache-2.0",
   "dependencies": {
     "ethers": "^5.5.2",
-    "@0xsequence/migration": "1.2.9",
-    "@0xsequence/core": "1.2.9",
-    "@0xsequence/network": "1.2.9",
-    "@0xsequence/relayer": "1.2.9",
-    "@0xsequence/sessions": "1.2.9",
-    "@0xsequence/utils": "1.2.9",
-    "@0xsequence/wallet": "1.2.9"
+    "@0xsequence/core": "1.4.0",
+    "@0xsequence/migration": "1.4.0",
+    "@0xsequence/network": "1.4.0",
+    "@0xsequence/relayer": "1.4.0",
+    "@0xsequence/sessions": "1.4.0",
+    "@0xsequence/utils": "1.4.0",
+    "@0xsequence/wallet": "1.4.0"
   },
   "devDependencies": {
     "@istanbuljs/nyc-config-typescript": "^1.0.2",
     "nyc": "^15.1.0",
-    "@0xsequence/signhub": "1.2.9",
-    "@0xsequence/tests": "1.2.9"
+    "@0xsequence/signhub": "1.4.0",
+    "@0xsequence/tests": "1.4.0"
   },
   "files": [
     "src",

package/src/account.ts

@@ -1,10 +1,11 @@
 import { commons, universal } from '@0xsequence/core'
+import { WalletSignRequestMetadata } from '@0xsequence/core/src/commons'
 import { migrator, defaults, version } from '@0xsequence/migration'
 import { ChainId, NetworkConfig } from '@0xsequence/network'
 import { FeeOption, FeeQuote, isRelayer, Relayer, RpcRelayer } from '@0xsequence/relayer'
 import { tracker } from '@0xsequence/sessions'
 import { Orchestrator } from '@0xsequence/signhub'
-import { encodeTypedDataDigest, getDefaultConnectionInfo } from '@0xsequence/utils'
+import { encodeTypedDataDigest, getEthersConnectionInfo } from '@0xsequence/utils'
 import { Wallet } from '@0xsequence/wallet'
 import { ethers, TypedDataDomain, TypedDataField } from 'ethers'
 import { AccountSigner, AccountSignerOptions } from './signer'
@@ -52,6 +53,9 @@ export type AccountOptions = {
 
   // Networks information and providers
   networks: NetworkConfig[]
+
+  // Jwt
+  jwt?: string
 }
 
 export interface PreparedTransactions {
@@ -95,6 +99,8 @@ export class Account {
 
   private orchestrator: Orchestrator
 
+  private jwt?: string
+
   constructor(options: AccountOptions) {
     this.address = ethers.utils.getAddress(options.address)
 
@@ -102,6 +108,7 @@ export class Account {
     this.tracker = options.tracker
     this.networks = options.networks
     this.orchestrator = options.orchestrator
+    this.jwt = options.jwt
 
     this.migrations = options.migrations || defaults.DefaultMigrations
     this.migrator = new migrator.Migrator(options.tracker, this.migrations, this.contexts)
@@ -173,7 +180,7 @@ export class Account {
     if (!found.provider && !found.rpcUrl) throw new Error(`Provider not found for chainId ${chainId}`)
     return (
       found.provider ||
-      new ethers.providers.StaticJsonRpcProvider(getDefaultConnectionInfo(found.rpcUrl), {
+      new ethers.providers.StaticJsonRpcProvider(getEthersConnectionInfo(found.rpcUrl, undefined, this.jwt), {
         name: '',
         chainId: ethers.BigNumber.from(chainId).toNumber()
       })
@@ -192,13 +199,17 @@ export class Account {
     const found = this.network(chainId)
     if (!found.relayer) throw new Error(`Relayer not found for chainId ${chainId}`)
     if (isRelayer(found.relayer)) return found.relayer
-    return new RpcRelayer(found.relayer)
+    return new RpcRelayer({ ...found.relayer, jwtAuth: this.jwt })
   }
 
   setOrchestrator(orchestrator: Orchestrator) {
     this.orchestrator = orchestrator
   }
 
+  setJwt(jwt: string) {
+    this.jwt = jwt
+  }
+
   contextFor(version: number): commons.context.WalletContext {
     const ctx = this.contexts[version]
     if (!ctx) throw new Error(`Context not found for version ${version}`)
@@ -352,6 +363,21 @@ export class Account {
     }
   }
 
+  async predecorateSignedTransactions(
+    status: AccountStatus,
+    chainId: ethers.BigNumberish
+  ): Promise<commons.transaction.SignedTransactionBundle[]> {
+    // Request signed predecorate transactions from child wallets
+    const bundles = await this.orchestrator.predecorateSignedTransactions({ chainId })
+    // Get signed predecorate transaction
+    const predecorated = await this.predecorateTransactions([], status, chainId)
+    if (commons.transaction.fromTransactionish(this.address, predecorated).length > 0) {
+      // Sign it
+      bundles.push(await this.signTransactions(predecorated, chainId))
+    }
+    return bundles
+  }
+
   async predecorateTransactions(
     txs: commons.transaction.Transactionish,
     status: AccountStatus,
@@ -369,29 +395,46 @@ export class Account {
     return txs
   }
 
-  decorateTransactions(
-    bundle: commons.transaction.IntendedTransactionBundle,
-    status: AccountStatus
-  ): commons.transaction.IntendedTransactionBundle {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, bundle.chainId)
-    if (bootstrapBundle.transactions.length === 0) {
-      return bundle
+  async decorateTransactions(
+    bundles: commons.transaction.IntendedTransactionBundle | commons.transaction.IntendedTransactionBundle[],
+    status: AccountStatus,
+    chainId?: ethers.BigNumberish
+  ): Promise<commons.transaction.IntendedTransactionBundle> {
+    if (!Array.isArray(bundles)) {
+      // Recurse with array
+      return this.decorateTransactions([bundles], status, chainId)
+    }
+
+    // Default to chainId of first bundle when not supplied
+    chainId = chainId ?? bundles[0].chainId
+
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId)
+    const hasBootstrapTxs = bootstrapBundle.transactions.length > 0
+
+    if (!hasBootstrapTxs && bundles.length === 1) {
+      return bundles[0]
     }
 
+    // Intent defaults to first bundle when no bootstrap transaction
+    const { entrypoint } = hasBootstrapTxs ? bootstrapBundle : bundles[0]
+
     const decoratedBundle = {
-      entrypoint: bootstrapBundle.entrypoint,
-      chainId: bundle.chainId,
-      intent: bundle.intent,
+      entrypoint,
+      chainId,
+      // Intent of the first bundle is used
+      intent: bundles[0].intent,
       transactions: [
         ...bootstrapBundle.transactions,
-        {
-          to: bundle.entrypoint,
-          data: commons.transaction.encodeBundleExecData(bundle),
-          gasLimit: 0,
-          delegateCall: false,
-          revertOnError: true,
-          value: 0
-        }
+        ...bundles.map(
+          (bundle): commons.transaction.Transaction => ({
+            to: bundle.entrypoint,
+            data: commons.transaction.encodeBundleExecData(bundle),
+            gasLimit: 0,
+            delegateCall: false,
+            revertOnError: true,
+            value: 0
+          })
+        )
       ]
     }
 
@@ -399,7 +442,7 @@ export class Account {
     if (!status.onChain.deployed) {
       decoratedBundle.intent.id = commons.transaction.subdigestOfGuestModuleTransactions(
         this.contexts[this.version].guestModule,
-        decoratedBundle.chainId,
+        chainId,
         decoratedBundle.transactions
       )
     }
@@ -407,12 +450,12 @@ export class Account {
     return decoratedBundle
   }
 
-  decorateSignature<T extends ethers.BytesLike>(
+  async decorateSignature<T extends ethers.BytesLike>(
     signature: T,
     status: Partial<Pick<AccountStatus, 'presignedConfigurations'>>
   ): Promise<T | string> {
     if (!status.presignedConfigurations || status.presignedConfigurations.length === 0) {
-      return new Promise(resolve => resolve(signature))
+      return signature
     }
 
     const coder = this.coders.signature
@@ -434,7 +477,8 @@ export class Account {
     digest: ethers.BytesLike,
     chainId: ethers.BigNumberish,
     decorate: boolean = true,
-    cantValidateBehavior: 'ignore' | 'eip6492' | 'throw' = 'ignore'
+    cantValidateBehavior: 'ignore' | 'eip6492' | 'throw' = 'ignore',
+    metadata?: object
   ): Promise<string> {
     // If we are signing a digest for chainId zero then we can never be fully migrated
     // because Sequence v1 doesn't allow for signing a message on "all chains"
@@ -442,10 +486,8 @@ export class Account {
     // So we ignore the state on "chain zero" and instead use one of the states of the networks
     // wallet-webapp should ensure the wallet is as migrated as possible, trying to mimic
     // the behaviour of being migrated on all chains
-
     const chainRef = ethers.constants.Zero.eq(chainId) ? this.networks[0].chainId : chainId
     const status = await this.status(chainRef)
-
     this.mustBeFullyMigrated(status)
 
     // Check if we can validate onchain and what to do if we can't
@@ -455,7 +497,7 @@ export class Account {
     }
 
     const wallet = this.walletForStatus(chainId, status)
-    const signature = await wallet.signDigest(digest)
+    const signature = await wallet.signDigest(digest, metadata)
 
     const decorated = decorate ? this.decorateSignature(signature, status) : signature
 
@@ -478,8 +520,8 @@ export class Account {
     return decorated
   }
 
-  private buildEIP6492Signature(signature: string, status: AccountStatus, chainId: ethers.BigNumberish): string {
-    const bootstrapBundle = this.buildBootstrapTransactions(status, chainId)
+  private async buildEIP6492Signature(signature: string, status: AccountStatus, chainId: ethers.BigNumberish): Promise<string> {
+    const bootstrapBundle = await this.buildBootstrapTransactions(status, chainId)
     if (bootstrapBundle.transactions.length === 0) {
       throw new Error('Cannot build EIP-6492 signature without bootstrap transactions')
     }
@@ -550,8 +592,12 @@ export class Account {
    *  by any of the migrations.
    *
    */
-  buildBootstrapTransactions(status: AccountStatus, chainId: ethers.BigNumberish): commons.transaction.IntendedTransactionBundle {
-    const transactions: commons.transaction.Transaction[] = []
+  async buildBootstrapTransactions(
+    status: AccountStatus,
+    chainId: ethers.BigNumberish
+  ): Promise<commons.transaction.IntendedTransactionBundle> {
+    const bundle = await this.orchestrator.buildDeployTransaction({ chainId })
+    const transactions: commons.transaction.Transaction[] = bundle?.transactions ?? []
 
     // Add wallet deployment if needed
     if (!status.onChain.deployed) {
@@ -561,6 +607,7 @@ export class Account {
 
       transactions.push(...deployTransaction.transactions)
     }
+    const len = transactions.length
 
     // Get pending migrations
     transactions.push(
@@ -622,7 +669,17 @@ export class Account {
     this.mustBeFullyMigrated(status)
 
     const wallet = this.walletForStatus(chainId, status)
-    const signed = await wallet.signTransactions(txs, options?.nonceSpace && { space: options?.nonceSpace })
+
+    const metadata: WalletSignRequestMetadata = {
+      address: this.address,
+      digest: '', // Set in wallet.signTransactions
+      chainId,
+      config: { version: this.version },
+      decorate: true,
+      cantValidateBehavior: 'ignore'
+    }
+
+    const signed = await wallet.signTransactions(txs, options?.nonceSpace && { space: options?.nonceSpace }, metadata)
 
     return {
       ...signed,
@@ -707,16 +764,19 @@ export class Account {
   }
 
   async sendSignedTransactions(
-    signedBundle: commons.transaction.IntendedTransactionBundle,
+    signedBundle: commons.transaction.IntendedTransactionBundle | commons.transaction.IntendedTransactionBundle[],
     chainId: ethers.BigNumberish,
     quote?: FeeQuote,
     pstatus?: AccountStatus,
     callback?: (bundle: commons.transaction.IntendedTransactionBundle) => void
   ): Promise<ethers.providers.TransactionResponse> {
-    const status = pstatus || (await this.status(signedBundle.chainId))
+    if (!Array.isArray(signedBundle)) {
+      return this.sendSignedTransactions([signedBundle], chainId, quote, pstatus, callback)
+    }
+    const status = pstatus || (await this.status(signedBundle[0].chainId))
     this.mustBeFullyMigrated(status)
 
-    const decoratedBundle = this.decorateTransactions(signedBundle, status)
+    const decoratedBundle = await this.decorateTransactions(signedBundle, status)
     callback?.(decoratedBundle)
 
     return this.relayer(chainId).relay(decoratedBundle, quote)
@@ -769,7 +829,7 @@ export class Account {
       nonce: 0 // The relayer also ignored the nonce
     }
 
-    const decoratedBundle = this.decorateTransactions(signedBundle, wstatus)
+    const decoratedBundle = await this.decorateTransactions(signedBundle, wstatus)
     const data = commons.transaction.encodeBundleExecData(decoratedBundle)
     const res = await this.relayer(chainId).getFeeOptionsRaw(decoratedBundle.entrypoint, data, options)
     return { ...res, decorated: decoratedBundle }
@@ -806,13 +866,27 @@ export class Account {
     options?: {
       nonceSpace?: ethers.BigNumberish
     }
-  ): Promise<ethers.providers.TransactionResponse> {
+  ): Promise<ethers.providers.TransactionResponse | undefined> {
     const status = await this.status(chainId)
 
     const predecorated = skipPreDecorate ? txs : await this.predecorateTransactions(txs, status, chainId)
-    const signed = await this.signTransactions(predecorated, chainId, undefined, options)
-    // TODO: is it safe to pass status again here?
-    return this.sendSignedTransactions(signed, chainId, quote, undefined, callback)
+    const hasTxs = commons.transaction.fromTransactionish(this.address, predecorated).length > 0
+    const signed = hasTxs ? await this.signTransactions(predecorated, chainId, undefined, options) : undefined
+
+    const childBundles = await this.orchestrator.predecorateSignedTransactions({ chainId })
+
+    const bundles: commons.transaction.SignedTransactionBundle[] = []
+    if (signed !== undefined && signed.transactions.length > 0) {
+      bundles.push(signed)
+    }
+    bundles.push(...childBundles.filter(b => b.transactions.length > 0))
+
+    if (bundles.length === 0) {
+      // Nothing to send?
+      return
+    }
+
+    return this.sendSignedTransactions(bundles, chainId, quote, undefined, callback)
   }
 
   async signTypedData(

package/src/orchestrator/wrapper.ts

@@ -0,0 +1,85 @@
+import { commons } from '@0xsequence/core'
+import { signers, Status } from '@0xsequence/signhub'
+import { ethers } from 'ethers'
+import { Account } from '../account'
+
+export type MetadataWithChainId = {
+  chainId: ethers.BigNumberish
+}
+
+// Implements a wrapper for using Sequence accounts as nested signers in the signhub orchestrator.
+export class AccountOrchestratorWrapper implements signers.SapientSigner {
+  constructor(public account: Account) {}
+
+  async getAddress(): Promise<string> {
+    return this.account.address
+  }
+
+  getChainIdFromMetadata(metadata: object): ethers.BigNumber {
+    try {
+      const { chainId } = metadata as MetadataWithChainId
+      return ethers.BigNumber.from(chainId)
+    } catch (err) {
+      // Invalid metadata object
+      throw new Error('AccountOrchestratorWrapper only supports metadata with chain id')
+    }
+  }
+
+  async buildDeployTransaction(metadata: object): Promise<commons.transaction.TransactionBundle | undefined> {
+    const chainId = this.getChainIdFromMetadata(metadata)
+    const status = await this.account.status(chainId)
+    return this.account.buildBootstrapTransactions(status, chainId)
+  }
+
+  async predecorateSignedTransactions(metadata: object): Promise<commons.transaction.SignedTransactionBundle[]> {
+    const chainId = this.getChainIdFromMetadata(metadata)
+    const status = await this.account.status(chainId)
+    return this.account.predecorateSignedTransactions(status, chainId)
+  }
+
+  async decorateTransactions(
+    bundle: commons.transaction.IntendedTransactionBundle,
+    metadata: object
+  ): Promise<commons.transaction.IntendedTransactionBundle> {
+    const chainId = this.getChainIdFromMetadata(metadata)
+    const status = await this.account.status(chainId)
+    return this.account.decorateTransactions(bundle, status)
+  }
+
+  async requestSignature(
+    _id: string,
+    message: ethers.utils.BytesLike,
+    metadata: object,
+    callbacks: {
+      onSignature: (signature: ethers.utils.BytesLike) => void
+      onRejection: (error: string) => void
+      onStatus: (situation: string) => void
+    }
+  ): Promise<boolean> {
+    if (!commons.isWalletSignRequestMetadata(metadata)) {
+      throw new Error('AccountOrchestratorWrapper only supports wallet metadata requests')
+    }
+
+    const { chainId, decorate } = metadata
+    // EIP-6492 not supported on nested signatures
+    // Default to throw instead of ignore. Ignoring should be explicit
+    const cantValidateBehavior = metadata.cantValidateBehavior ?? 'throw'
+
+    // For Sequence nested signatures we must use `signDigest` and not `signMessage`
+    // otherwise the account will hash the digest and the signature will be invalid.
+    try {
+      callbacks.onSignature(await this.account.signDigest(message, chainId, decorate, cantValidateBehavior, metadata))
+    } catch (err) {
+      callbacks.onRejection('Unable to sign account')
+      return false
+    }
+
+    return true
+  }
+
+  notifyStatusChange(_i: string, _s: Status, _m: object): void {}
+
+  suffix(): ethers.utils.BytesLike {
+    return [3]
+  }
+}

package/src/signer.ts

@@ -157,7 +157,7 @@ export class AccountSigner implements ethers.Signer {
             nonceSpace: this.options.nonceSpace
           }
         : undefined
-    )
+    ) as Promise<ethers.providers.TransactionResponse> // Will always have a transaction response
   }
 
   getBalance(blockTag?: ethers.providers.BlockTag | undefined): Promise<ethers.BigNumber> {