feat: Add signInMulti method

examples/angular/src/app/components/content/content.component.ts

@@ -291,14 +291,14 @@ export class ContentComponent implements OnInit, OnDestroy {
   }
 
   async addMessages(message: string, donation: string, multiple: boolean) {
-    const { contract } = this.selector.store.getState();
     const wallet = await this.selector.wallet();
 
     if (!multiple) {
       return wallet
         .signAndSendTransaction({
           // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
           signerId: this.accountId!,
+          receiverId: CONTRACT_ID,
           actions: [
             {
               type: "FunctionCall",
@@ -327,7 +327,7 @@ export class ContentComponent implements OnInit, OnDestroy {
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         signerId: this.accountId!,
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        receiverId: contract!.contractId,
+        receiverId: CONTRACT_ID,
         actions: [
           {
             type: "FunctionCall",

examples/angular/src/app/pages/wallet-selector/wallet-selector.component.ts

@@ -161,7 +161,7 @@ export class WalletSelectorComponent implements OnInit {
     });
 
     const _modal = setupModal(_selector, {
-      contractId: CONTRACT_ID,
+      contracts: [{ receiverId: CONTRACT_ID, methodNames: [] }],
     });
     const state = _selector.store.getState();
 

examples/react/components/Content.tsx

@@ -160,12 +160,12 @@ const Content: React.FC = () => {
 
   const addMessages = useCallback(
     async (message: string, donation: string, multiple: boolean) => {
-      const { contract } = selector.store.getState();
       const wallet = await selector.wallet();
       if (!multiple) {
         return wallet
           .signAndSendTransaction({
             signerId: accountId!,
+            receiverId: CONTRACT_ID,
             actions: [
               {
                 type: "FunctionCall",
@@ -191,7 +191,7 @@ const Content: React.FC = () => {
       for (let i = 0; i < 2; i += 1) {
         transactions.push({
           signerId: accountId!,
-          receiverId: contract!.contractId,
+          receiverId: CONTRACT_ID,
           actions: [
             {
               type: "FunctionCall",

examples/react/contexts/WalletSelectorContext.tsx

@@ -192,7 +192,7 @@ export const WalletSelectorContextProvider: React.FC<{
       ],
     });
     const _modal = setupModal(_selector, {
-      contractId: CONTRACT_ID,
+      contracts: [{ receiverId: CONTRACT_ID, methodNames: [] }],
     });
     const state = _selector.store.getState();
     setAccounts(state.accounts);

packages/bitget-wallet/src/lib/bitget-wallet.ts

@@ -191,15 +191,15 @@ const BitgetWallet: WalletBehaviourFactory<InjectedWallet> = async ({
     async signAndSendTransaction({ signerId, receiverId, actions }) {
       logger.log("signAndSendTransaction", { signerId, receiverId, actions });
 
-      const { contract } = store.getState();
+      const { contracts } = store.getState();
 
-      if (!_state.wallet.isSignedIn() || !contract) {
+      if (!_state.wallet.isSignedIn() || contracts.length < 1) {
         throw new Error("Wallet not signed in");
       }
 
       return _state.wallet
         .signAndSendTransaction({
-          receiverId: receiverId || contract.contractId,
+          receiverId: receiverId,
           actions: actions,
         })
         .then((res) => {

packages/coin98-wallet/src/lib/coin98-wallet.ts

@@ -70,11 +70,11 @@ const Coin98Wallet: WalletBehaviourFactory<InjectedWallet> = async ({
   };
 
   const transformTransactions = (
-    transactions: Array<Optional<Transaction, "signerId" | "receiverId">>
+    transactions: Array<Optional<Transaction, "signerId">>
   ): Array<Transaction> => {
-    const { contract } = store.getState();
+    const { contracts } = store.getState();
 
-    if (!contract) {
+    if (contracts.length < 1) {
       throw new Error("Wallet not signed in");
     }
 
@@ -87,7 +87,7 @@ const Coin98Wallet: WalletBehaviourFactory<InjectedWallet> = async ({
     return transactions.map((transaction) => {
       return {
         signerId: transaction.signerId || account.accountId,
-        receiverId: transaction.receiverId || contract.contractId,
+        receiverId: transaction.receiverId,
         actions: transaction.actions,
       };
     });

packages/core/docs/api/state.md

@@ -1,22 +1,22 @@
 ## API Reference (State)
-
-### `.contract`
+### `.contracts`
 
 **Returns**
 
-- `ContractState | null`
+- `MultiContractState`
   - `contractId` (`string`): Account ID of the Smart Contract.
   - `methodNames` (`Array<string>`): List of methods that can only be invoked on the Smart Contract. Empty list means no restriction.
 
 **Description**
 
-Returns the signed in contract.
+Returns the signed in contracts when signing-in with `signInMulti`.
 
 **Example**
 
 ```ts
-const { contract } = selector.store.getState();
-console.log(contract); // { contractId: "test.testnet", methodNames: [] }
+// MultiContractState = Array<ContractState>;
+const { contracts } = selector.store.getState();
+console.log(contracts); // [{ contractId: "test.testnet", methodNames: [] }, { contractId: "test1.testnet", methodNames: [] }]
 ```
 
 ### `.modules`

packages/core/docs/api/wallet.md

@@ -91,9 +91,9 @@ Returns meta information about the wallet such as `name`, `description`, `iconUr
   - `contractId` (`string`): Account ID of the Smart Contract.
   - `methodNames` (`Array<string>?`): Specify limited access to particular methods on the Smart Contract.
   - `accounts` (`Array<{derivationPath: string, publicKey: string, accountId: string}>?`): Required for hardware wallets (e.g. Ledger). This is a list of `accounts` linked to public keys on your device.
-  - `qrCodeModal` (`boolean?`): Optional for bridge wallets (e.g Wallet Connect). This indicates whether to render QR Code in wallet selector modal or use the default vendor modal.
-  - `successUrl` (`string?`): Optional for browser wallets (e.g MyNearWallet and HERE Wallet). After successfully signing in where to redirect.
-  - `failureUrl` (`string?`): Optional for browser wallets (e.g MyNearWallet and HERE Wallet). After failing to sign in where to redirect.
+  - `qrCodeModal` (`boolean?`): Optional for bridge wallets (e.g. Wallet Connect). This indicates whether to render QR Code in wallet selector modal or use the default vendor modal.
+  - `successUrl` (`string?`): Optional for browser wallets (e.g. MyNearWallet and NEAR Wallet). After successfully signing in where to redirect.
+  - `failureUrl` (`string?`): Optional for browser wallets (e.g. MyNearWallet and NEAR Wallet). After failing to sign in where to redirect.
 
 **Returns**
 
@@ -148,6 +148,94 @@ Programmatically sign in. Hardware wallets (e.g. Ledger) require `derivationPath
 })();
 ```
 
+### `.signInMulti(params)`
+
+**Parameters**
+
+- `params` (`object`)
+
+  - `permissions`(`Array<{allowance?: BN, receiverId: string, methodNames: Array<string>}>`): List of Account ID-s of the Smart Contracts and the limited access to particular methods on the Smart Contract.
+  - `accounts` (`Array<{derivationPath: string, publicKey: string, accountId: string}>?`): Required for hardware wallets (e.g. Ledger). This is a list of `accounts` linked to public keys on your device.
+  - `qrCodeModal` (`boolean?`): Optional for bridge wallets (e.g. Wallet Connect). This indicates whether to render QR Code in wallet selector modal or use the default vendor modal.
+  - `successUrl` (`string?`): Optional for browser wallets (e.g. MyNearWallet and NEAR Wallet). After successfully signing in where to redirect.
+  - `failureUrl` (`string?`): Optional for browser wallets (e.g. MyNearWallet and NEAR Wallet). After failing to sign in where to redirect.
+
+**Returns**
+
+- `Promise<Array<Account>>`
+
+**Description**
+
+Programmatically sign in. Hardware wallets (e.g. Ledger) require `derivationPaths` to validate access key permissions.
+
+**Example**
+
+```ts
+// NEAR Wallet.
+(async () => {
+  const wallet = await selector.wallet("near-wallet");
+  const accounts = await wallet.signInMulti({
+    permissions: [
+      { receiverId: "test.testnet", methodNames: [] },
+      { receiverId: "test1.testnet", methodNames: [] }
+    ]
+  });
+})();
+
+// Sender.
+(async () => {
+  const wallet = await selector.wallet("sender");
+  const accounts = await wallet.signInMulti({
+    permissions: [
+      { receiverId: "test.testnet", methodNames: [] },
+      { receiverId: "test1.testnet", methodNames: [] }
+    ]
+  });
+})();
+
+// Math Wallet.
+(async () => {
+  const wallet = await selector.wallet("math-wallet");
+  const accounts = await wallet.signInMulti({
+    permissions: [
+      { receiverId: "test.testnet", methodNames: [] },
+      { receiverId: "test1.testnet", methodNames: [] }
+    ]
+  });
+})();
+
+// Ledger
+(async () => {
+  const wallet = await selector.wallet("ledger");
+  const derivationPath = "44'/397'/0'/0'/1'";
+  const publicKey = await wallet.getPublicKey(derivationPath);
+  const accountId = "youraccountid.testnet"
+
+  const accounts = await wallet.signIn({
+    permissions: [
+      { receiverId: "test.testnet", methodNames: [] },
+      { receiverId: "test1.testnet", methodNames: [] }
+    ],
+    accounts: [{
+      derivationPath,
+      publicKey,
+      accountId
+    }],
+  });
+})();
+
+// WalletConnect.
+(async () => {
+  const wallet = await selector.wallet("wallet-connect");
+  const accounts = await wallet.signInMulti({
+    permissions: [
+      { receiverId: "test.testnet", methodNames: [] },
+      { receiverId: "test1.testnet", methodNames: [] }
+    ]
+  });
+})();
+```
+
 ### `.signOut()`
 
 **Parameters**
@@ -230,7 +318,7 @@ Signs the message and verifies the owner. Message is not sent to blockchain.
 
 - `params` (`object`)
   - `signerId` (`string?`): Account ID used to sign the transaction. Defaults to the first account.
-  - `receiverId` (`string?`): Account ID to receive the transaction. Defaults to `contractId` defined in `.init`.
+  - `receiverId` (`string`): Account ID to receive the transaction. Defaults to `contractId` defined in `.init`.
   - `actions` (`Array<Action>`): NEAR Action(s) to sign and send to the network (e.g. `FunctionCall`). You can find more information on `Action` [here](./transactions.md).
   - `callbackUrl` (`string?`): Applicable to browser wallets (e.g. MyNearWallet). This the callback url once the transaction is approved.
 

packages/core/docs/guides/custom-wallets.md

@@ -31,6 +31,12 @@ const MyWallet: WalletBehaviourFactory<BrowserWallet> = ({
       return [];
     },
 
+    async signInMulti({ permissions }) {
+      // Sign in to My Wallet with multiple contracts.
+
+      return [];
+    },
+
     async signOut() {
       // Sign out from accounts and cleanup (e.g. listeners).
     },

packages/core/src/index.ts

@@ -21,6 +21,7 @@ export type { Optional } from "./lib/utils.types";
 export type {
   WalletSelectorState,
   ContractState,
+  MultiContractState,
   ModuleState,
   AccountState,
 } from "./lib/store.types";
@@ -35,6 +36,7 @@ export type {
   WalletMetadata,
   WalletEvents,
   SignInParams,
+  SignInMultiParams,
   BrowserWalletMetadata,
   BrowserWalletBehaviour,
   BrowserWallet,

packages/core/src/lib/constants.ts

@@ -9,5 +9,8 @@ export const REMEMBER_RECENT_WALLETS_STATE = {
 export const CONTRACT = "contract";
 export const PENDING_CONTRACT = "contract:pending";
 
+export const CONTRACTS = "contracts";
+export const PENDING_CONTRACTS = "contracts:pending";
+
 export const SELECTED_WALLET_ID = `selectedWalletId`;
 export const PENDING_SELECTED_WALLET_ID = `selectedWalletId:pending`;