Class VirtualAccountQueryService

constructor

• new VirtualAccountQueryService(
      args: {
          db: B2bDatabase;
          productQuoteService: ProductQuoteService;
          valkeyClient: ValkeyClient | null;
      },
  ): VirtualAccountQueryService

  Parameters

  • args: {
        db: B2bDatabase;
        productQuoteService: ProductQuoteService;
        valkeyClient: ValkeyClient | null;
    }

  Returns VirtualAccountQueryService

Staticinstance

get

• get(
      args: { customerId: string; id: string },
  ): Promise<
      {
          ok: true;
          value: | {
              accountNumber: string;
              achDepositInstructions: AchDepositInstructions
              | null;
              createdAt: Date;
              data:
                  | {
                      provider: "VICTOR";
                      victorId: string;
                      victorLedgerProgramId: string;
                  }
                  | {
                      entityId: string;
                      entityInput?: {
                          businessAddress1: string;
                          businessAddress2?: string;
                          businessCity: string;
                          businessCountry: string;
                          businessName: string;
                          businessPostalCode: string;
                          businessStateProvinceRegion?: string;
                          businessType?: | "b_corporation"
                          | "c_corporation"
                          | "close_corporation"
                          | "cooperative"
                          | "general_partnership"
                          | "limited_liability_company"
                          | "limited_partnership"
                          | "nonprofit_corporation"
                          | "s_corporation"
                          | "sole_proprietorship"
                          | "non_us";
                          contactFirstName: string;
                          contactLastName: string;
                          email: string;
                          incorporationDate?: string;
                          phone?: string;
                          phoneCountry?: string;
                          taxNumber?: string;
                          websiteUrl?: string;
                      };
                      fundingInstructions: | {
                          accountHolderAddress1?: string
                          | null;
                          accountHolderAddress2?: string | null;
                          accountHolderCity?: string | null;
                          accountHolderCountry?: string | null;
                          accountHolderName: string | null;
                          accountHolderPostalCode?: string | null;
                          accountHolderStateProvinceRegion?: string | null;
                          accountNumber: string | null;
                          bankAddress1?: string | null;
                          bankAddress2?: string | null;
                          bankCity?: string | null;
                          bankCountry: string | null;
                          bankName: string | null;
                          bankPostalCode?: string | null;
                          bankStateProvinceRegion?: string | null;
                          currency: string | null;
                          message?: string | null;
                          qr?: { base64Image: ...; expirationDate: ...; qrDecoded: ... } | null;
                          reference: string | null;
                          routingCode: string | null;
                          routingCodeAlternate?: string | null;
                          swiftBic: string | null;
                          taxNumber?: string | null;
                          type: string | null;
                      }
                      | null;
                      programId: string;
                      provider: "ROUTE_FUSION";
                      walletId: string;
                  }
                  | { accountId?: string; masterAccountId: string; provider: "ZENUS" }
                  | null;
              deletedAt: Date | null;
              id: string;
              name: string | null;
              providerId: string;
              providerName: string;
              providerType: "VICTOR" | "BIVO" | "ROUTE_FUSION" | "ZENUS" | "MANUAL";
              providerTypeDescription: string;
              referenceId: string | null;
              routingNumber: string;
              rtpDepositInstructions: RtpDepositInstructions | null;
              status: "PENDING" | "ACTIVE" | "FAILED" | "INACTIVE";
              statusDescription: string;
              swiftDepositInstructions:
                  | (
                      | Omit<UsdSwiftWireInstructionData, "swiftField70Prefix"> & {
                          receivingEntityName: string;
                          swiftField70: SwiftField70Prefix;
                      }
                      | Omit<ForeignSwiftWireInstructionData, "swiftField70Prefix"> & {
                          receivingEntityName: string;
                          swiftField70: SwiftField70Prefix;
                      }
                  )[]
                  | null;
              type: "US_DEPOSIT"
              | "US_DDA";
              typeDescription: string;
              updatedAt: Date;
              walletAddress: Address;
              wireDepositInstructions: UsWireDepositInstructions | null;
          } & { customerId: string; entityId: string; ledgerAccountId: string }
          | null;
      },
  >

  Parameters

  • args: { customerId: string; id: string }

  Returns Promise<
      {
          ok: true;
          value: | {
              accountNumber: string;
              achDepositInstructions: AchDepositInstructions
              | null;
              createdAt: Date;
              data:
                  | {
                      provider: "VICTOR";
                      victorId: string;
                      victorLedgerProgramId: string;
                  }
                  | {
                      entityId: string;
                      entityInput?: {
                          businessAddress1: string;
                          businessAddress2?: string;
                          businessCity: string;
                          businessCountry: string;
                          businessName: string;
                          businessPostalCode: string;
                          businessStateProvinceRegion?: string;
                          businessType?: | "b_corporation"
                          | "c_corporation"
                          | "close_corporation"
                          | "cooperative"
                          | "general_partnership"
                          | "limited_liability_company"
                          | "limited_partnership"
                          | "nonprofit_corporation"
                          | "s_corporation"
                          | "sole_proprietorship"
                          | "non_us";
                          contactFirstName: string;
                          contactLastName: string;
                          email: string;
                          incorporationDate?: string;
                          phone?: string;
                          phoneCountry?: string;
                          taxNumber?: string;
                          websiteUrl?: string;
                      };
                      fundingInstructions: | {
                          accountHolderAddress1?: string
                          | null;
                          accountHolderAddress2?: string | null;
                          accountHolderCity?: string | null;
                          accountHolderCountry?: string | null;
                          accountHolderName: string | null;
                          accountHolderPostalCode?: string | null;
                          accountHolderStateProvinceRegion?: string | null;
                          accountNumber: string | null;
                          bankAddress1?: string | null;
                          bankAddress2?: string | null;
                          bankCity?: string | null;
                          bankCountry: string | null;
                          bankName: string | null;
                          bankPostalCode?: string | null;
                          bankStateProvinceRegion?: string | null;
                          currency: string | null;
                          message?: string | null;
                          qr?: { base64Image: ...; expirationDate: ...; qrDecoded: ... } | null;
                          reference: string | null;
                          routingCode: string | null;
                          routingCodeAlternate?: string | null;
                          swiftBic: string | null;
                          taxNumber?: string | null;
                          type: string | null;
                      }
                      | null;
                      programId: string;
                      provider: "ROUTE_FUSION";
                      walletId: string;
                  }
                  | { accountId?: string; masterAccountId: string; provider: "ZENUS" }
                  | null;
              deletedAt: Date | null;
              id: string;
              name: string | null;
              providerId: string;
              providerName: string;
              providerType: "VICTOR" | "BIVO" | "ROUTE_FUSION" | "ZENUS" | "MANUAL";
              providerTypeDescription: string;
              referenceId: string | null;
              routingNumber: string;
              rtpDepositInstructions: RtpDepositInstructions | null;
              status: "PENDING" | "ACTIVE" | "FAILED" | "INACTIVE";
              statusDescription: string;
              swiftDepositInstructions:
                  | (
                      | Omit<UsdSwiftWireInstructionData, "swiftField70Prefix"> & {
                          receivingEntityName: string;
                          swiftField70: SwiftField70Prefix;
                      }
                      | Omit<ForeignSwiftWireInstructionData, "swiftField70Prefix"> & {
                          receivingEntityName: string;
                          swiftField70: SwiftField70Prefix;
                      }
                  )[]
                  | null;
              type: "US_DEPOSIT"
              | "US_DDA";
              typeDescription: string;
              updatedAt: Date;
              walletAddress: Address;
              wireDepositInstructions: UsWireDepositInstructions | null;
          } & { customerId: string; entityId: string; ledgerAccountId: string }
          | null;
      },
  >

invalidateTag

• invalidateTag(arg: { customerId: string }): Promise<void>

  Busts the search cache for a specific customer. Called by the colocated writer (VictorVirtualAccountService) after create / update / delete so that only the affected customer's cached searches are dropped, leaving all other customers' caches intact.

  Parameters

  • arg: { customerId: string }

  Returns Promise<void>

resolveMintRoute

• resolveMintRoute(
      args: {
          customerId: string;
          entityId: string;
          ledgerAccountId?: string;
          providerType: VirtualAccountMintProvider;
      },
  ): Promise<
      { ok: true; value: MintRoute }
      | { error: MintRouteError; ok: false },
  >

  resolveMintRoutes for one provider.

  Parameters

  • args: {
        customerId: string;
        entityId: string;
        ledgerAccountId?: string;
        providerType: VirtualAccountMintProvider;
    }

  Returns Promise<{ ok: true; value: MintRoute } | { error: MintRouteError; ok: false }>

resolveMintRoutes

• resolveMintRoutes(
      args: {
          customerId: string;
          entityId: string;
          ledgerAccountId?: string;
          providerTypes: readonly VirtualAccountMintProvider[];
      },
  ): Promise<
      ({ ok: true; value: MintRoute } | { error: MintRouteError; ok: false })[],
  >

  The mint route per provider intent, in one batch, as a placement narrowed by grants (PROGRAM_ROUTING.md § 3.5), each checked by mintRouteFrom.

  Parameters

  • args: {
        customerId: string;
        entityId: string;
        ledgerAccountId?: string;
        providerTypes: readonly VirtualAccountMintProvider[];
    }

  Returns Promise<
      ({ ok: true; value: MintRoute } | { error: MintRouteError; ok: false })[],
  >

search

• search(
      args: {
          customerId: string;
          ids?: string[];
          ledgerAccountAddresses?: Address[];
          ledgerAccountIds?: string[];
          page?: number;
          pageSize?: number;
      },
  ): Promise<
      {
          ok: true;
          value: {
              hasNext: boolean;
              items: VirtualAccountSearchItem[];
              total: number;
          };
      },
  >

  Parameters

  • args: {
        customerId: string;
        ids?: string[];
        ledgerAccountAddresses?: Address[];
        ledgerAccountIds?: string[];
        page?: number;
        pageSize?: number;
    }

  Returns Promise<
      {
          ok: true;
          value: {
              hasNext: boolean;
              items: VirtualAccountSearchItem[];
              total: number;
          };
      },
  >