@venlyfinance/react 0.1.1 → 0.2.0

package/README.md

@@ -126,4 +126,6 @@ npm test          # node:test, zero network
 npm run build
 ```
 
+See it assembled end to end: [`examples/mock-bank`](../examples/mock-bank/) runs a full account experience on these hooks in mock mode – `npm install && npm run dev`, fake data, zero credentials.
+
 MIT. Part of the [venly-settlement-sdk](https://github.com/Venly/venly-settlement-sdk) monorepo alongside `@venlyfinance/sdk` and `@venlyfinance/settlement-mcp`.

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { VenlyProvider, useVenly, useVenlyMock, type VenlyClients, type VenlyProviderProps, type VenlyReactEnvironment, } from "./provider.js";
 export { venlyKeys } from "./keys.js";
 export { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery, } from "./query-options.js";
-export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, } from "./queries.js";
-export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, } from "./mutations.js";
+export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, } from "./queries.js";
+export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, useCreateCompanyBankAccount, useCreateCompanyWallet, useSetRampAmount, useInitiateRamp, } from "./mutations.js";
 export { StagedTransferController, useStagedTransfer, validateDraft, type StagedRequest, type StagedTransferOptions, type StagedTransferState, type TransferDraft, } from "./flows/staged-transfer.js";
 export { approvalCapabilities, interpretApprovalError, useFourEyesApproval, type ApprovalCapability, type ApprovalFailureKind, type FourEyesState, } from "./flows/four-eyes.js";
 export { describeRampStatus, useRampLifecycle, type RampLifecycleOptions, type RampStatus, type RampStatusDescriptor, } from "./flows/ramp-lifecycle.js";

package/dist/index.js

@@ -4,9 +4,9 @@ export { VenlyProvider, useVenly, useVenlyMock, } from "./provider.js";
 export { venlyKeys } from "./keys.js";
 export { venlyQueries, } from "./query-options.js";
 // Read hooks
-export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, } from "./queries.js";
+export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, } from "./queries.js";
 // Write hooks
-export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, } from "./mutations.js";
+export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, useCreateCompanyBankAccount, useCreateCompanyWallet, useSetRampAmount, useInitiateRamp, } from "./mutations.js";
 // Flow machines: the regulated-money lifecycles
 export { StagedTransferController, useStagedTransfer, validateDraft, } from "./flows/staged-transfer.js";
 export { approvalCapabilities, interpretApprovalError, useFourEyesApproval, } from "./flows/four-eyes.js";

package/dist/keys.d.ts

@@ -15,6 +15,12 @@ export declare const venlyKeys: {
     readonly rampRequests: (query?: unknown) => readonly ["venly", "ramp-requests", {} | null];
     readonly rampRequest: (id: string) => readonly ["venly", "ramp-request", string];
     readonly referenceData: () => readonly ["venly", "reference-data"];
+    readonly companyBankAccounts: (query?: unknown) => readonly ["venly", "company-bank-accounts", {} | null];
+    readonly companyBankAccount: (id: string) => readonly ["venly", "company-bank-account", string];
+    readonly companyWallets: (query?: unknown) => readonly ["venly", "company-wallets", {} | null];
+    readonly bankAccountConfig: () => readonly ["venly", "bank-account-config"];
+    readonly depositWallets: (query?: unknown) => readonly ["venly", "deposit-wallets", {} | null];
+    readonly rampPairs: (direction: "on" | "off") => readonly ["venly", "ramp-pairs", "on" | "off"];
     readonly companyFees: () => readonly ["venly", "company-fees"];
     readonly feeQuote: (input: unknown) => readonly ["venly", "fee-quote", unknown];
 };

package/dist/keys.js

@@ -15,6 +15,12 @@ export const venlyKeys = {
     rampRequests: (query) => ["venly", "ramp-requests", query ?? null],
     rampRequest: (id) => ["venly", "ramp-request", id],
     referenceData: () => ["venly", "reference-data"],
+    companyBankAccounts: (query) => ["venly", "company-bank-accounts", query ?? null],
+    companyBankAccount: (id) => ["venly", "company-bank-account", id],
+    companyWallets: (query) => ["venly", "company-wallets", query ?? null],
+    bankAccountConfig: () => ["venly", "bank-account-config"],
+    depositWallets: (query) => ["venly", "deposit-wallets", query ?? null],
+    rampPairs: (direction) => ["venly", "ramp-pairs", direction],
     companyFees: () => ["venly", "company-fees"],
     feeQuote: (input) => ["venly", "fee-quote", input],
 };

package/dist/mutations.d.ts

@@ -1,4 +1,4 @@
-import type { VenlyFinanceClient } from "@venlyfinance/sdk";
+import type { FundflowClient, VenlyFinanceClient } from "@venlyfinance/sdk";
 type CreateVibaBody = Parameters<VenlyFinanceClient["virtualBankAccounts"]["create"]>[1];
 type CreatePaymentSessionBody = Parameters<VenlyFinanceClient["paymentSessions"]["create"]>[1];
 /** Create a party (individual or organisation), then refresh party lists. */
@@ -120,4 +120,89 @@ export declare function useCreateRampRequest(): import("@tanstack/react-query").
     fiatCurrencyId: string;
     cryptoCurrencyId: string;
 }, unknown>;
+type SetRampAmountBody = Parameters<FundflowClient["rampRequests"]["setAmount"]>[1];
+type InitiateRampBody = Parameters<FundflowClient["rampRequests"]["initiate"]>[1];
+/** Whitelist a company bank account (created PENDING, verified out-of-band). */
+export declare function useCreateCompanyBankAccount(): import("@tanstack/react-query").UseMutationResult<import("@venlyfinance/sdk").CompanyBankAccountDetails, Error, import("@venlyfinance/sdk").CreateCompanyBankAccountInput, unknown>;
+/** Whitelist a company wallet (created PENDING; prove ownership out-of-band). */
+export declare function useCreateCompanyWallet(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    description?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    verifiedAt?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    version?: number;
+}, Error, {
+    description?: string;
+    address: string;
+    chain: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+}, unknown>;
+/** Edit a ramp amount while AWAITING_APPROVAL; carries the optimistic lock. */
+export declare function useSetRampAmount(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    companyName?: string;
+    rampType?: "ON_RAMP" | "OFF_RAMP";
+    status?: "AWAITING_APPROVAL" | "AWAITING_FUNDS" | "PROCESSING" | "SUCCEEDED" | "FAILED" | "BLOCKED" | "DENIED" | "REJECTED" | "CANCELLED";
+    amount?: number;
+    netAmount?: number;
+    fiatAmount?: number;
+    fiatNetAmount?: number;
+    cryptoAmount?: number;
+    fiatFeeAmount?: number;
+    exchangeRate?: number;
+    feePercentage?: number;
+    paymentReference?: string;
+    paymentReceived?: boolean;
+    blockchainTransactionHash?: string;
+    createdAt?: string;
+    companyBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireCompanyBankAccountDto"];
+    companyWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CompanyWalletDto"];
+    depositBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireDepositBankAccountDto"];
+    depositWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["DepositWalletDto"];
+    fiatCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatCurrencyDto"];
+    cryptoCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoCurrencyDto"];
+    events?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["RampRequestEventDto"][];
+    version?: number;
+    amountReceived?: number;
+}, Error, {
+    id: string;
+    body: SetRampAmountBody;
+}, unknown>;
+/** Report the off-ramp crypto leg's transaction hash (initiates processing). */
+export declare function useInitiateRamp(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    companyName?: string;
+    rampType?: "ON_RAMP" | "OFF_RAMP";
+    status?: "AWAITING_APPROVAL" | "AWAITING_FUNDS" | "PROCESSING" | "SUCCEEDED" | "FAILED" | "BLOCKED" | "DENIED" | "REJECTED" | "CANCELLED";
+    amount?: number;
+    netAmount?: number;
+    fiatAmount?: number;
+    fiatNetAmount?: number;
+    cryptoAmount?: number;
+    fiatFeeAmount?: number;
+    exchangeRate?: number;
+    feePercentage?: number;
+    paymentReference?: string;
+    paymentReceived?: boolean;
+    blockchainTransactionHash?: string;
+    createdAt?: string;
+    companyBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireCompanyBankAccountDto"];
+    companyWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CompanyWalletDto"];
+    depositBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireDepositBankAccountDto"];
+    depositWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["DepositWalletDto"];
+    fiatCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatCurrencyDto"];
+    cryptoCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoCurrencyDto"];
+    events?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["RampRequestEventDto"][];
+    version?: number;
+    amountReceived?: number;
+}, Error, {
+    id: string;
+    body: InitiateRampBody;
+}, unknown>;
 export {};

package/dist/mutations.js

@@ -56,3 +56,51 @@ export function useCreateRampRequest() {
         },
     });
 }
+/** Whitelist a company bank account (created PENDING, verified out-of-band). */
+export function useCreateCompanyBankAccount() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (body) => fundflow.bankAccounts.create(body),
+        onSuccess: (account) => {
+            if (account.id)
+                queryClient.setQueryData(venlyKeys.companyBankAccount(account.id), account);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "company-bank-accounts"] });
+        },
+    });
+}
+/** Whitelist a company wallet (created PENDING; prove ownership out-of-band). */
+export function useCreateCompanyWallet() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (body) => fundflow.companyWallets.create(body),
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: ["venly", "company-wallets"] });
+        },
+    });
+}
+/** Edit a ramp amount while AWAITING_APPROVAL; carries the optimistic lock. */
+export function useSetRampAmount() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (input) => fundflow.rampRequests.setAmount(input.id, input.body),
+        onSuccess: (ramp, input) => {
+            queryClient.setQueryData(venlyKeys.rampRequest(input.id), ramp);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "ramp-requests"] });
+        },
+    });
+}
+/** Report the off-ramp crypto leg's transaction hash (initiates processing). */
+export function useInitiateRamp() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (input) => fundflow.rampRequests.initiate(input.id, input.body),
+        onSuccess: (ramp, input) => {
+            queryClient.setQueryData(venlyKeys.rampRequest(input.id), ramp);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "ramp-requests"] });
+        },
+    });
+}

package/dist/provider.d.ts

@@ -62,5 +62,5 @@ export declare function useVenly(): VenlyClients;
  */
 export declare function useVenlyMock(): {
     finance: import("@venlyfinance/sdk").VenlyFinanceMock | undefined;
-    fundflow: import("@venlyfinance/sdk").VenlyMock | undefined;
+    fundflow: import("@venlyfinance/sdk").VenlyFundflowMock | undefined;
 };

package/dist/queries.d.ts

@@ -1,5 +1,5 @@
 import { type UseQueryOptions } from "@tanstack/react-query";
-import { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery } from "./query-options.js";
+import { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery, type CompanyBankAccountsQuery, type CompanyWalletsQuery, type DepositWalletsQuery } from "./query-options.js";
 type Tune<T> = Omit<UseQueryOptions<T, Error>, "queryKey" | "queryFn">;
 export declare function useParties(query?: PartiesQuery, options?: Tune<PartiesPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
     id?: string;
@@ -197,4 +197,81 @@ export declare function useFeeQuote(input: FeeQuoteInput | undefined, options?:
     percentage?: number;
 }>, Error>;
 type FeeQuote = Awaited<ReturnType<ReturnType<typeof venlyQueries.feeQuote>["queryFn"]>>;
+export declare function useCompanyBankAccounts(query?: CompanyBankAccountsQuery, options?: Tune<BankAccountsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+    id?: string;
+    name?: string;
+    bankName?: string;
+    bankCountry?: string;
+    bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+    supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    createdAt?: string;
+    updatedAt?: string;
+}>>, Error>;
+type BankAccountsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyBankAccounts>["queryFn"]>>;
+export declare function useCompanyBankAccount(id: string | undefined, options?: Tune<BankAccountDetail>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    id?: string;
+    companyId?: string;
+    name?: string;
+    bankName?: string;
+    companyName?: string;
+    email?: string;
+    phoneNumber?: string;
+    bankCountry?: string;
+    beneficiaryAddressLine1?: string;
+    beneficiaryAddressLine2?: string;
+    beneficiaryCity?: string;
+    beneficiaryState?: string;
+    beneficiaryPostalCode?: string;
+    beneficiaryCountry?: string;
+    bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+    supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    verifiedAt?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    version?: number;
+} & {
+    iban?: string;
+    bic?: string;
+    intermediaryBic?: string;
+    intermediaryBankName?: string;
+    accountNumber?: string;
+    sortCode?: string;
+    routingNumber?: string;
+    bankStreetAddress?: string;
+    bankCity?: string;
+    bankPostalCode?: string;
+    currency?: string;
+}>, Error>;
+type BankAccountDetail = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyBankAccount>["queryFn"]>>;
+export declare function useCompanyWallets(query?: CompanyWalletsQuery, options?: Tune<WalletsListPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+    id?: string;
+    description?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    createdAt?: string;
+    updatedAt?: string;
+}>>, Error>;
+type WalletsListPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyWallets>["queryFn"]>>;
+export declare function useBankAccountConfig(options?: Tune<BankAccountConfigData>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    enabledAccountTypes?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["BankAccountTypeDto"][];
+    supportedCountries?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CountryDto"][];
+    supportedCurrencies?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CurrencyItemDto"][];
+}>, Error>;
+type BankAccountConfigData = Awaited<ReturnType<ReturnType<typeof venlyQueries.bankAccountConfig>["queryFn"]>>;
+export declare function useDepositWallets(query?: DepositWalletsQuery, options?: Tune<DepositWalletsData>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    id?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    label?: string;
+    isDefault?: boolean;
+    isActive?: boolean;
+    version?: number;
+}[]>, Error>;
+type DepositWalletsData = Awaited<ReturnType<ReturnType<typeof venlyQueries.depositWallets>["queryFn"]>>;
+/** Supported on/off-ramp currency pairs, for destination/asset pickers. */
+export declare function useRampPairs(direction: "on" | "off", options?: Tune<RampPairsData>): import("@tanstack/react-query").UseQueryResult<NoInfer<RampPairsData>, Error>;
+type RampPairsData = Awaited<ReturnType<ReturnType<typeof venlyQueries.rampPairs>["queryFn"]>>;
 export {};

package/dist/queries.js

@@ -89,3 +89,40 @@ export function useFeeQuote(input, options) {
         ...options,
     });
 }
+export function useCompanyBankAccounts(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.companyBankAccounts(clients, query), ...options });
+}
+export function useCompanyBankAccount(id, options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.companyBankAccount(clients, id ?? ""),
+        enabled: Boolean(id) && (options?.enabled ?? true),
+        ...options,
+    });
+}
+export function useCompanyWallets(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.companyWallets(clients, query), ...options });
+}
+export function useBankAccountConfig(options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.bankAccountConfig(clients),
+        staleTime: Infinity, // enabled types/countries change on deploys, not minutes
+        ...options,
+    });
+}
+export function useDepositWallets(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.depositWallets(clients, query), ...options });
+}
+/** Supported on/off-ramp currency pairs, for destination/asset pickers. */
+export function useRampPairs(direction, options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.rampPairs(clients, direction),
+        staleTime: Infinity,
+        ...options,
+    });
+}

package/dist/query-options.d.ts

@@ -7,6 +7,9 @@ export type VirtualBankAccountsQuery = NonNullable<Parameters<VenlyFinanceClient
 export type TransfersQuery = NonNullable<Parameters<VenlyFinanceClient["transfers"]["list"]>[1]>;
 export type RampRequestsQuery = NonNullable<Parameters<FundflowClient["rampRequests"]["list"]>[0]>;
 export type FeeQuoteInput = Parameters<FundflowClient["fees"]["calculate"]>[0];
+export type CompanyBankAccountsQuery = NonNullable<Parameters<FundflowClient["bankAccounts"]["list"]>[0]>;
+export type CompanyWalletsQuery = NonNullable<Parameters<FundflowClient["companyWallets"]["list"]>[0]>;
+export type DepositWalletsQuery = NonNullable<Parameters<FundflowClient["referenceData"]["depositWallets"]>[0]>;
 /**
  * Pure `{ queryKey, queryFn }` factories, one per read. The hooks in
  * queries.ts are one-line wrappers over these; anything that needs the same
@@ -241,4 +244,64 @@ export declare const venlyQueries: {
             percentage?: number;
         }>;
     };
+    readonly companyBankAccounts: (clients: VenlyClients, query?: CompanyBankAccountsQuery) => {
+        queryKey: readonly ["venly", "company-bank-accounts", {} | null];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            id?: string;
+            name?: string;
+            bankName?: string;
+            bankCountry?: string;
+            bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+            supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+            verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+            createdAt?: string;
+            updatedAt?: string;
+        }>>;
+    };
+    readonly companyBankAccount: (clients: VenlyClients, id: string) => {
+        queryKey: readonly ["venly", "company-bank-account", string];
+        queryFn: () => Promise<import("@venlyfinance/sdk").CompanyBankAccountDetails>;
+    };
+    readonly companyWallets: (clients: VenlyClients, query?: CompanyWalletsQuery) => {
+        queryKey: readonly ["venly", "company-wallets", {} | null];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            id?: string;
+            description?: string;
+            address?: string;
+            chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+            verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+            createdAt?: string;
+            updatedAt?: string;
+        }>>;
+    };
+    readonly bankAccountConfig: (clients: VenlyClients) => {
+        queryKey: readonly ["venly", "bank-account-config"];
+        queryFn: () => Promise<{
+            enabledAccountTypes?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["BankAccountTypeDto"][];
+            supportedCountries?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CountryDto"][];
+            supportedCurrencies?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CurrencyItemDto"][];
+        }>;
+    };
+    readonly depositWallets: (clients: VenlyClients, query?: DepositWalletsQuery) => {
+        queryKey: readonly ["venly", "deposit-wallets", {} | null];
+        queryFn: () => Promise<{
+            id?: string;
+            address?: string;
+            chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+            label?: string;
+            isDefault?: boolean;
+            isActive?: boolean;
+            version?: number;
+        }[]>;
+    };
+    readonly rampPairs: (clients: VenlyClients, direction: "on" | "off") => {
+        queryKey: readonly ["venly", "ramp-pairs", "on" | "off"];
+        queryFn: () => Promise<{
+            from?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatPairItem"];
+            to?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoPairItem"];
+        }[]> | Promise<{
+            from?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoPairItem"];
+            to?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatPairItem"];
+        }[]>;
+    };
 };

package/dist/query-options.js

@@ -70,4 +70,30 @@ export const venlyQueries = {
         queryKey: venlyKeys.feeQuote(input),
         queryFn: () => clients.fundflow.fees.calculate(input),
     }),
+    companyBankAccounts: (clients, query) => ({
+        queryKey: venlyKeys.companyBankAccounts(query),
+        queryFn: () => clients.fundflow.bankAccounts.list(query),
+    }),
+    companyBankAccount: (clients, id) => ({
+        queryKey: venlyKeys.companyBankAccount(id),
+        queryFn: () => clients.fundflow.bankAccounts.get(id),
+    }),
+    companyWallets: (clients, query) => ({
+        queryKey: venlyKeys.companyWallets(query),
+        queryFn: () => clients.fundflow.companyWallets.list(query),
+    }),
+    bankAccountConfig: (clients) => ({
+        queryKey: venlyKeys.bankAccountConfig(),
+        queryFn: () => clients.fundflow.referenceData.bankAccountConfig(),
+    }),
+    depositWallets: (clients, query) => ({
+        queryKey: venlyKeys.depositWallets(query),
+        queryFn: () => clients.fundflow.referenceData.depositWallets(query),
+    }),
+    rampPairs: (clients, direction) => ({
+        queryKey: venlyKeys.rampPairs(direction),
+        queryFn: () => direction === "on"
+            ? clients.fundflow.rampRequests.onRampPairs()
+            : clients.fundflow.rampRequests.offRampPairs(),
+    }),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venlyfinance/react",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Headless React layer for the Venly Finance and Fundflow APIs: provider, TanStack Query hooks, and flow state machines for regulated money movement. Runs with zero credentials in mock mode.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@venlyfinance/sdk": "^0.2.0"
+    "@venlyfinance/sdk": "^0.3.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",