near-api-js 7.0.4 → 7.1.1

package/lib/accounts/account.d.ts

@@ -3,8 +3,8 @@ import { type Provider } from '../providers/index.js';
 import type { RpcTransactionResponse } from '../rpc/types.gen.js';
 import { type SignedMessage, type Signer } from '../signers/index.js';
 import type { SignDelegateActionReturn } from '../signers/signer.js';
-import type { FungibleToken, NativeToken } from '../tokens/index.js';
-import { type Action, type DelegateAction, type SignedTransaction } from '../transactions/index.js';
+import { FungibleToken, type NativeToken } from '../tokens/index.js';
+import { type Action, type DelegateAction, type SignedDelegate, type SignedTransaction } from '../transactions/index.js';
 import type { SerializedReturnValue, TxExecutionStatus } from '../types/index.js';
 export declare const DEFAULT_WAIT_STATUS: TxExecutionStatus;
 export interface AccountState {
@@ -307,6 +307,13 @@ export declare class Account {
      * @returns The available balance of the account in units (e.g. yoctoNEAR).
      */
     getBalance(token?: NativeToken | FungibleToken): Promise<bigint>;
+    /**
+     * Relay a meta-transaction signed by a different account
+     *
+     * @param signedDelegate The signed delegate action to relay
+     * @returns The transaction response from the relayed meta-transaction
+     */
+    relayMetaTransaction(signedDelegate: SignedDelegate): Promise<RpcTransactionResponse>;
     /**
      * Transfers a token to the specified receiver.
      *

package/lib/accounts/account.js

@@ -3,7 +3,7 @@ import { parseTransactionExecutionError } from '../providers/errors/parse.js';
 import { InvalidNonceError } from '../providers/errors/transaction_execution.js';
 import { JsonRpcProvider } from '../providers/index.js';
 import { KeyPairSigner } from '../signers/index.js';
-import { NEAR } from '../tokens/index.js';
+import { FungibleToken, NEAR } from '../tokens/index.js';
 import { actions, buildDelegateAction, createTransaction, } from '../transactions/index.js';
 import { baseDecode, getTransactionLastResult } from '../utils/index.js';
 import { NonceManager } from './nonce-manager.js';
@@ -488,6 +488,18 @@ export class Account {
     async getBalance(token = NEAR) {
         return token.getBalance(this);
     }
+    /**
+     * Relay a meta-transaction signed by a different account
+     *
+     * @param signedDelegate The signed delegate action to relay
+     * @returns The transaction response from the relayed meta-transaction
+     */
+    async relayMetaTransaction(signedDelegate) {
+        return this.signAndSendTransaction({
+            receiverId: signedDelegate.delegateAction.senderId,
+            actions: [actions.signedDelegate(signedDelegate)],
+        });
+    }
     /**
      * Transfers a token to the specified receiver.
      *
@@ -500,6 +512,15 @@ export class Account {
      *
      */
     async transfer({ receiverId, amount, token = NEAR }) {
+        if (token instanceof FungibleToken) {
+            const isRegistered = await token.isAccountRegistered({ accountId: receiverId, provider: this.provider });
+            if (!isRegistered) {
+                await token.registerAccount({
+                    accountIdToRegister: receiverId,
+                    fundingAccount: this,
+                });
+            }
+        }
         return token.transfer({ from: this, receiverId, amount });
     }
 }

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 export * from './accounts/index.js';
 export type { CurveType, KeyPairString, Signature as CryptoSignature, } from './crypto/index.js';
-export { KeyPair, KeyPairEd25519, KeyPairSecp256k1, KeyType, PublicKey, } from './crypto/index.js';
+export { KeyPair, KeyPairEd25519, KeyPairSecp256k1, KeyType, keyToImplicitAddress, PublicKey, } from './crypto/index.js';
 export * from './providers/index.js';
 export * from './signers/index.js';
 export * from './transactions/index.js';

package/lib/index.js

@@ -8,7 +8,7 @@ export * from './accounts/index.js';
 // ============================================================================
 // Cryptography
 // ============================================================================
-export { KeyPair, KeyPairEd25519, KeyPairSecp256k1, KeyType, PublicKey, } from './crypto/index.js';
+export { KeyPair, KeyPairEd25519, KeyPairSecp256k1, KeyType, keyToImplicitAddress, PublicKey, } from './crypto/index.js';
 // ============================================================================
 // Providers
 // ============================================================================

package/lib/tokens/ft/index.d.ts

@@ -1,4 +1,5 @@
 import type { Account } from '../../accounts/account.js';
+import type { Provider } from '../../providers/provider.js';
 interface FTMetadata {
     spec?: string;
     name: string;
@@ -61,7 +62,10 @@ export declare class FungibleToken extends BaseFT {
         receiverId: string;
         amount: string | number | bigint;
     }): Promise<any>;
-    getBalance(account: Account): Promise<bigint>;
+    getBalance({ accountId, provider }: {
+        accountId: string;
+        provider: Provider;
+    }): Promise<bigint>;
     /**
      * Transfer tokens and call a function on the receiver contract,
      * only works if the receiver implements the `ft_on_transfer` method
@@ -100,6 +104,18 @@ export declare class FungibleToken extends BaseFT {
         account: Account;
         force: boolean;
     }): Promise<any>;
+    /**
+     * Checks if an account is registered to the fungible token contract
+     *
+     * @param param
+     * @param param.accountId The AccountID to check
+     * @param param.provider A Provider to use for the query
+     * @returns Whether the account is registered
+     */
+    isAccountRegistered({ accountId, provider, }: {
+        accountId: string;
+        provider: Provider;
+    }): Promise<boolean>;
 }
 /**
  * The NEAR token is the native token of the NEAR blockchain

package/lib/tokens/ft/index.js

@@ -1,4 +1,5 @@
 import { actions } from '../../transactions/action_creators.js';
+import { teraToGas } from '../../units/gas.js';
 import { formatAmount, parseAmount } from './format.js';
 class BaseFT {
     constructor(metadata) {
@@ -51,15 +52,15 @@ export class FungibleToken extends BaseFT {
                 amount: amount.toString(),
                 receiver_id: receiverId,
             },
-            gas: '30000000000000',
+            gas: teraToGas(30),
             deposit: 1,
         });
     }
-    async getBalance(account) {
-        const balance = await account.provider.callFunction({
+    async getBalance({ accountId, provider }) {
+        const balance = await provider.callFunction({
             contractId: this.accountId,
             method: 'ft_balance_of',
-            args: { account_id: account.accountId },
+            args: { account_id: accountId },
         });
         return BigInt(balance);
     }
@@ -82,7 +83,7 @@ export class FungibleToken extends BaseFT {
                 amount: amount.toString(),
                 msg,
             },
-            gas: '30000000000000',
+            gas: teraToGas(30),
             deposit: 1,
         });
     }
@@ -107,7 +108,7 @@ export class FungibleToken extends BaseFT {
                 account_id: accountIdToRegister,
                 registration_only: true,
             },
-            gas: '30000000000000',
+            gas: teraToGas(30),
             deposit: requiredDeposit,
         });
     }
@@ -123,10 +124,35 @@ export class FungibleToken extends BaseFT {
             contractId: this.accountId,
             methodName: 'storage_unregister',
             args: { force },
-            gas: '30000000000000',
+            gas: teraToGas(30),
             deposit: 1,
         });
     }
+    /**
+     * Checks if an account is registered to the fungible token contract
+     *
+     * @param param
+     * @param param.accountId The AccountID to check
+     * @param param.provider A Provider to use for the query
+     * @returns Whether the account is registered
+     */
+    async isAccountRegistered({ accountId, provider, }) {
+        const [storage, required] = await Promise.all([
+            provider.callFunction({
+                contractId: this.accountId,
+                method: 'storage_balance_of',
+                args: { account_id: accountId },
+            }),
+            provider.callFunction({
+                contractId: this.accountId,
+                method: 'storage_balance_bounds',
+                args: {},
+            }),
+        ]);
+        if (!storage)
+            return false;
+        return BigInt(storage.total) >= BigInt(required.min);
+    }
 }
 /**
  * The NEAR token is the native token of the NEAR blockchain

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "near-api-js",
   "description": "JavaScript library to interact with NEAR Protocol via RPC API",
-  "version": "7.0.4",
+  "version": "7.1.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/near/near-api-js.git"