feat: add Stellar account asset info RPC

packages/snap/src/context.ts

@@ -11,6 +11,7 @@ import {
   ClientRequestMethod,
 } from './handlers/clientRequest';
 import { ComputeFeeHandler } from './handlers/clientRequest/computeFee';
+import { GetAccountAssetInfoHandler } from './handlers/clientRequest/getAccountAssetInfo';
 import { OnAddressInputHandler } from './handlers/clientRequest/onAddressInput';
 import { OnAmountInputHandler } from './handlers/clientRequest/onAmountInput';
 import { SignAndSendTransactionHandler } from './handlers/clientRequest/signAndSendTransaction';
@@ -30,6 +31,7 @@ import {
   SignTransactionHandler,
 } from './handlers/keyring';
 import { AccountService, AccountsRepository } from './services/account';
+import { AccountAssetInfoService } from './services/account-asset-info';
 import {
   AssetMetadataRepository,
   AssetMetadataService,
@@ -98,6 +100,13 @@ const onChainAccountService = new OnChainAccountService({
   assetMetadataService,
 });
 
+const accountAssetInfoService = new AccountAssetInfoService({
+  logger,
+  accountService,
+  onChainAccountService,
+  assetMetadataService,
+});
+
 const transactionService = new TransactionService({
   logger,
   transactionRepository,
@@ -244,11 +253,17 @@ const computeFeeHandler = new ComputeFeeHandler({
   transactionService,
 });
 
+const getAccountAssetInfoHandler = new GetAccountAssetInfoHandler({
+  logger,
+  accountAssetInfoService,
+});
+
 const clientRequestMethodHandlers: Record<
   ClientRequestMethod,
   IClientRequestHandler
 > = {
   [ClientRequestMethod.ChangeTrustOpt]: changeTrustOptHandler,
+  [ClientRequestMethod.GetAccountAssetInfo]: getAccountAssetInfoHandler,
   [ClientRequestMethod.OnAddressInput]: onAddressInputHandler,
   [ClientRequestMethod.OnAmountInput]: onAmountInputHandler,
   [ClientRequestMethod.SignAndSendTransaction]: signAndSendTransactionHandler,

packages/snap/src/handlers/clientRequest/api.test.ts

@@ -12,6 +12,8 @@ import {
   ClientRequestMethod,
   ClientRequestMethodStruct,
   JsonRpcRequestWithAccountStruct,
+  GetAccountAssetInfoJsonRpcRequestStruct,
+  GetAccountAssetInfoJsonRpcResponseStruct,
   OnAddressInputJsonRpcRequestStruct,
   OnAddressInputJsonRpcResponseStruct,
   OnAmountInputJsonRpcRequestStruct,
@@ -618,3 +620,56 @@ describe('OnAmountInputJsonRpcResponseStruct', () => {
     },
   );
 });
+
+describe('GetAccountAssetInfoJsonRpcRequestStruct', () => {
+  it('accepts a valid getAccountAssetInfo JSON-RPC request', () => {
+    expect(() =>
+      assert(
+        {
+          jsonrpc: '2.0',
+          id: 1,
+          method: ClientRequestMethod.GetAccountAssetInfo,
+          params: {
+            accountId,
+            scope,
+            assets: [classicAssetId],
+          },
+        },
+        GetAccountAssetInfoJsonRpcRequestStruct,
+      ),
+    ).not.toThrow();
+  });
+
+  it('rejects getAccountAssetInfo when scope is missing', () => {
+    expect(() =>
+      assert(
+        {
+          jsonrpc: '2.0',
+          id: 1,
+          method: ClientRequestMethod.GetAccountAssetInfo,
+          params: {
+            accountId,
+            assets: [classicAssetId],
+          },
+        },
+        GetAccountAssetInfoJsonRpcRequestStruct,
+      ),
+    ).toThrow(StructError);
+  });
+});
+
+describe('GetAccountAssetInfoJsonRpcResponseStruct', () => {
+  it('accepts a valid getAccountAssetInfo JSON-RPC response', () => {
+    expect(() =>
+      assert(
+        {
+          [classicAssetId]: {
+            metadata: { name: 'USD Coin', symbol: 'USDC', units: [] },
+            extra: { limit: '1' },
+          },
+        },
+        GetAccountAssetInfoJsonRpcResponseStruct,
+      ),
+    ).not.toThrow();
+  });
+});

packages/snap/src/handlers/clientRequest/api.ts

@@ -15,6 +15,7 @@ import {
   nonempty,
   integer,
   min,
+  record,
 } from '@metamask/superstruct';
 import type { JsonRpcRequest } from '@metamask/utils';
 import { parseCaipAssetType } from '@metamask/utils';
@@ -33,6 +34,7 @@ import {
   ValidStellarAmountStruct,
   SwapTransactionXdrStruct,
 } from '../../api';
+import { AccountAssetInfoEntryStruct } from '../../services/account-asset-info';
 import { isSep41Id } from '../../utils';
 
 /**
@@ -47,6 +49,7 @@ export enum ClientRequestMethod {
   ComputeFee = 'computeFee',
   /** -------------------------------- Stellar Specific -------------------------------- */
   ChangeTrustOpt = 'changeTrustOpt',
+  GetAccountAssetInfo = 'getAccountAssetInfo',
 }
 
 export enum MultiChainSendErrorCodes {
@@ -136,6 +139,37 @@ export const ChangeTrustOptJsonRpcResponseStruct = object({
   transactionId: optional(StellarTransactionHashStruct),
 });
 
+const GetAccountAssetInfoParamsStruct = object({
+  accountId: UuidStruct,
+  scope: KnownCaip2ChainIdStruct,
+  assets: array(
+    union([
+      KnownCaip19Sep41AssetStruct,
+      KnownCaip19ClassicAssetStruct,
+      KnownCaip19Slip44IdStruct,
+    ]),
+  ),
+});
+
+/**
+ * Validation struct for the getAccountAssetInfo JSON-RPC request.
+ */
+export const GetAccountAssetInfoJsonRpcRequestStruct = assign(
+  JsonRpcRequestStruct,
+  object({
+    method: literal(ClientRequestMethod.GetAccountAssetInfo),
+    params: GetAccountAssetInfoParamsStruct,
+  }),
+);
+
+/**
+ * Validation struct for the getAccountAssetInfo JSON-RPC response.
+ */
+export const GetAccountAssetInfoJsonRpcResponseStruct = record(
+  string(),
+  AccountAssetInfoEntryStruct,
+);
+
 /**
  * Validation struct for the sendTransaction JSON-RPC request.
  */
@@ -283,6 +317,20 @@ export type ChangeTrustOptJsonRpcResponse = Infer<
   typeof ChangeTrustOptJsonRpcResponseStruct
 >;
 
+/**
+ * Type for the getAccountAssetInfo JSON-RPC request.
+ */
+export type GetAccountAssetInfoJsonRpcRequest = Infer<
+  typeof GetAccountAssetInfoJsonRpcRequestStruct
+>;
+
+/**
+ * Type for the getAccountAssetInfo JSON-RPC response.
+ */
+export type GetAccountAssetInfoJsonRpcResponse = Infer<
+  typeof GetAccountAssetInfoJsonRpcResponseStruct
+>;
+
 /**
  * Type for the onAddressInput JSON-RPC request.
  */

packages/snap/src/handlers/clientRequest/changeTrustOpt.test.ts

@@ -263,6 +263,10 @@ describe('ChangeTrustOptHandler', () => {
       txId: '7d4b0c5ef7498b223f45a10f461060fb64f53eb13caf18e8dc7de95a8cf9c0e1',
       scope,
       accountIds: [account.id],
+      trustlineVerification: {
+        assetId,
+        action: ChangeTrustOptAction.Add,
+      },
     });
   });
 
@@ -362,6 +366,10 @@ describe('ChangeTrustOptHandler', () => {
       txId: '7d4b0c5ef7498b223f45a10f461060fb64f53eb13caf18e8dc7de95a8cf9c0e1',
       scope,
       accountIds: [account.id],
+      trustlineVerification: {
+        assetId,
+        action: ChangeTrustOptAction.Delete,
+      },
     });
   });
 

packages/snap/src/handlers/clientRequest/changeTrustOpt.ts

@@ -159,6 +159,10 @@ export class ChangeTrustOptHandler extends BaseClientRequestHandler<
       txId: transactionId,
       scope,
       accountIds: [account.id],
+      trustlineVerification: {
+        assetId,
+        action,
+      },
     });
 
     return {