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`;