Class InstantDepositQuoteService

constructor

• new InstantDepositQuoteService(
      args: {
          bankTransactionService: BankTransactionService;
          depositAdminService: DepositAdminService;
          depositQuoteService: DepositQuoteService;
          ledgerAccountQueryService: LedgerAccountQueryService;
          productQuoteService: ProductQuoteService;
          temporalClient: TemporalWorkflowClient<Workflows>;
      },
  ): InstantDepositQuoteService

  Parameters

  • args: {
        bankTransactionService: BankTransactionService;
        depositAdminService: DepositAdminService;
        depositQuoteService: DepositQuoteService;
        ledgerAccountQueryService: LedgerAccountQueryService;
        productQuoteService: ProductQuoteService;
        temporalClient: TemporalWorkflowClient<Workflows>;
    }

  Returns InstantDepositQuoteService

Staticinstance

accept

• accept(
      args: {
          customerId: string;
          idempotencyKey: string;
          onCancelled?: "return" | "recreate";
          quoteId: string;
      },
  ): Promise<{ ok: true; value: { depositId: string } }>

  Parameters

  • args: {
        customerId: string;
        idempotencyKey: string;
        onCancelled?: "return" | "recreate";
        quoteId: string;
    }

    • customerId: string

    • idempotencyKey: string

    • OptionalonCancelled?: "return" | "recreate"

      Only processFromBankTransaction passes "recreate". Left at the default here, where the key is customer-supplied and idempotency means the same key always answers the same thing.

    • quoteId: string

  Returns Promise<{ ok: true; value: { depositId: string } }>

create

• create(
      args: {
          customerId: string;
          entityId: string;
          ffcMemo?: string;
          idempotencyKey?: string;
          sourceAmount: BigNumber;
          sourceCurrency: string;
          targetCurrency: "MOVEUSD";
          walletAddress: Address;
          walletBlockchain: "SOLANA";
      } & InstantDepositSender,
  ): Promise<
      | { error: QuoteError; ok: false }
      | { ok: true; value: DepositQuote | null },
  >

  Parameters

  • args: {
        customerId: string;
        entityId: string;
        ffcMemo?: string;
        idempotencyKey?: string;
        sourceAmount: BigNumber;
        sourceCurrency: string;
        targetCurrency: "MOVEUSD";
        walletAddress: Address;
        walletBlockchain: "SOLANA";
    } & InstantDepositSender

    • customerId: string

    • entityId: string

    • OptionalffcMemo?: string

    • OptionalidempotencyKey?: string

      Caller-supplied dedupe token threaded into the audit quote so a re-drive of the same source (e.g. bank-transaction webhook redelivery) reuses the pinned product_quote instead of orphaning a fresh one.

    • sourceAmount: BigNumber

    • sourceCurrency: string

    • targetCurrency: "MOVEUSD"

    • walletAddress: Address

    • walletBlockchain: "SOLANA"

  Returns Promise<
      | { error: QuoteError; ok: false }
      | { ok: true; value: DepositQuote | null },
  >

processFromBankTransaction

• processFromBankTransaction(
      args: {
          bankTransactionId: string;
          customerId: string;
          entityId: string;
          memo?: string;
          walletAddress: Address;
          walletBlockchain: "SOLANA";
      } & InstantDepositSenderFallback,
  ): Promise<
      | { ok: true; value: { depositId: string } }
      | {
          error:
              | ServiceError<"QUOTE_FAILED">
              | ServiceError<"INVALID_BANK_TX", { bankTransactionId: string }>
              | ServiceError<"NOT_INSTANT_PAYMENT", { bankTransactionId: string }>
              | ServiceError<
                  "DEPOSIT_CANCELLED_AFTER_MINT",
                  { depositId: string; receiptId: string },
              >;
          ok: false;
      },
  >

  The network comes from the bank transaction's method, RTP or FEDNOW; any other row is refused. The sender fields are fallbacks, each filling its field only when the row lacks it.

  Parameters

  • args: {
        bankTransactionId: string;
        customerId: string;
        entityId: string;
        memo?: string;
        walletAddress: Address;
        walletBlockchain: "SOLANA";
    } & InstantDepositSenderFallback

  Returns Promise<
      | { ok: true; value: { depositId: string } }
      | {
          error:
              | ServiceError<"QUOTE_FAILED">
              | ServiceError<"INVALID_BANK_TX", { bankTransactionId: string }>
              | ServiceError<"NOT_INSTANT_PAYMENT", { bankTransactionId: string }>
              | ServiceError<
                  "DEPOSIT_CANCELLED_AFTER_MINT",
                  { depositId: string; receiptId: string },
              >;
          ok: false;
      },
  >