@spritz-finance/api-client 0.8.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -530,90 +530,6 @@ interface paths {
530
530
  patch?: never;
531
531
  trace?: never;
532
532
  };
533
- "/v1/deposit-destinations/prepare": {
534
- parameters: {
535
- query?: never;
536
- header?: never;
537
- path?: never;
538
- cookie?: never;
539
- };
540
- get?: never;
541
- put?: never;
542
- /**
543
- * Prepare a deposit destination bind
544
- * @description Creates the canonical message a wallet must sign to bind a deposit destination to a funding source.
545
- */
546
- post: operations["postV1Deposit-destinationsPrepare"];
547
- delete?: never;
548
- options?: never;
549
- head?: never;
550
- patch?: never;
551
- trace?: never;
552
- };
553
- "/v1/deposit-destinations/": {
554
- parameters: {
555
- query?: never;
556
- header?: never;
557
- path?: never;
558
- cookie?: never;
559
- };
560
- /**
561
- * List deposit destinations
562
- * @description Returns the authenticated user's bound deposit destinations.
563
- */
564
- get: operations["getV1Deposit-destinations"];
565
- put?: never;
566
- /**
567
- * Bind a deposit destination
568
- * @description Verifies the signed destination bind message and stores the bound wallet destination.
569
- */
570
- post: operations["postV1Deposit-destinations"];
571
- delete?: never;
572
- options?: never;
573
- head?: never;
574
- patch?: never;
575
- trace?: never;
576
- };
577
- "/v1/deposits/prepare": {
578
- parameters: {
579
- query?: never;
580
- header?: never;
581
- path?: never;
582
- cookie?: never;
583
- };
584
- get?: never;
585
- put?: never;
586
- /**
587
- * Prepare a deposit authorization
588
- * @description Creates the canonical ACH authorization message a wallet must sign for a single deposit.
589
- */
590
- post: operations["postV1DepositsPrepare"];
591
- delete?: never;
592
- options?: never;
593
- head?: never;
594
- patch?: never;
595
- trace?: never;
596
- };
597
- "/v1/deposits/": {
598
- parameters: {
599
- query?: never;
600
- header?: never;
601
- path?: never;
602
- cookie?: never;
603
- };
604
- get?: never;
605
- put?: never;
606
- /**
607
- * Create a deposit
608
- * @description Verifies the signed ACH authorization and creates a deposit for asynchronous debit and release processing.
609
- */
610
- post: operations["postV1Deposits"];
611
- delete?: never;
612
- options?: never;
613
- head?: never;
614
- patch?: never;
615
- trace?: never;
616
- };
617
533
  "/v1/deposits/direct/prepare": {
618
534
  parameters: {
619
535
  query?: never;
@@ -1971,26 +1887,6 @@ interface paths {
1971
1887
  patch?: never;
1972
1888
  trace?: never;
1973
1889
  };
1974
- "/v1/sandbox/deposits": {
1975
- parameters: {
1976
- query?: never;
1977
- header?: never;
1978
- path?: never;
1979
- cookie?: never;
1980
- };
1981
- get?: never;
1982
- put?: never;
1983
- /**
1984
- * Create a sandbox deposit with an armed ACH return
1985
- * @description Creates a deposit in sandbox and routes the Modern Treasury debit through a return-code-backed receiving account for end-to-end return testing.
1986
- */
1987
- post: operations["postV1SandboxDeposits"];
1988
- delete?: never;
1989
- options?: never;
1990
- head?: never;
1991
- patch?: never;
1992
- trace?: never;
1993
- };
1994
1890
  "/v1/sandbox/deposits/direct": {
1995
1891
  parameters: {
1996
1892
  query?: never;
@@ -2877,7 +2773,7 @@ interface operations {
2877
2773
  "application/json": {
2878
2774
  /**
2879
2775
  * @description Destination account ID
2880
- * @example 69fcc3849e56476d70fe629a
2776
+ * @example 6a05da63c358f286e124b9fc
2881
2777
  */
2882
2778
  accountId: string;
2883
2779
  /**
@@ -2905,7 +2801,7 @@ interface operations {
2905
2801
  "application/x-www-form-urlencoded": {
2906
2802
  /**
2907
2803
  * @description Destination account ID
2908
- * @example 69fcc3849e56476d70fe629a
2804
+ * @example 6a05da63c358f286e124b9fc
2909
2805
  */
2910
2806
  accountId: string;
2911
2807
  /**
@@ -2933,7 +2829,7 @@ interface operations {
2933
2829
  "multipart/form-data": {
2934
2830
  /**
2935
2831
  * @description Destination account ID
2936
- * @example 69fcc3849e56476d70fe629a
2832
+ * @example 6a05da63c358f286e124b9fc
2937
2833
  */
2938
2834
  accountId: string;
2939
2835
  /**
@@ -2980,7 +2876,7 @@ interface operations {
2980
2876
  /**
2981
2877
  * Format: date-time
2982
2878
  * @description When the quote was created
2983
- * @example 2026-05-07T16:53:24.366Z
2879
+ * @example 2026-05-14T14:21:23.458Z
2984
2880
  */
2985
2881
  createdAt: string;
2986
2882
  /** @description What the user pays — total USD cost and token used. */
@@ -3019,7 +2915,7 @@ interface operations {
3019
2915
  rail: "ach_standard" | "ach_same_day" | "rtp" | "wire" | "eft" | "sepa" | "faster_payments" | "push_to_card" | "bill_pay" | "card_deposit";
3020
2916
  /**
3021
2917
  * @description Destination account ID
3022
- * @example 69fcc3849e56476d70fe629b
2918
+ * @example 6a05da63c358f286e124b9fd
3023
2919
  */
3024
2920
  accountId: string;
3025
2921
  };
@@ -3226,7 +3122,7 @@ interface operations {
3226
3122
  /**
3227
3123
  * Format: date-time
3228
3124
  * @description When the quote was created
3229
- * @example 2026-05-07T16:53:24.366Z
3125
+ * @example 2026-05-14T14:21:23.458Z
3230
3126
  */
3231
3127
  createdAt: string;
3232
3128
  /** @description What the user pays — total USD cost and token used. */
@@ -3265,7 +3161,7 @@ interface operations {
3265
3161
  rail: "ach_standard" | "ach_same_day" | "rtp" | "wire" | "eft" | "sepa" | "faster_payments" | "push_to_card" | "bill_pay" | "card_deposit";
3266
3162
  /**
3267
3163
  * @description Destination account ID
3268
- * @example 69fcc3849e56476d70fe629b
3164
+ * @example 6a05da63c358f286e124b9fd
3269
3165
  */
3270
3166
  accountId: string;
3271
3167
  };
@@ -3762,7 +3658,7 @@ interface operations {
3762
3658
  currency: string;
3763
3659
  /**
3764
3660
  * @description Destination account ID
3765
- * @example 69fcc3849e56476d70fe629c
3661
+ * @example 6a05da63c358f286e124b9fe
3766
3662
  */
3767
3663
  accountId: string;
3768
3664
  accountName: (string | null) | null;
@@ -3978,7 +3874,7 @@ interface operations {
3978
3874
  currency: string;
3979
3875
  /**
3980
3876
  * @description Destination account ID
3981
- * @example 69fcc3849e56476d70fe629c
3877
+ * @example 6a05da63c358f286e124b9fe
3982
3878
  */
3983
3879
  accountId: string;
3984
3880
  accountName: (string | null) | null;
@@ -7700,7 +7596,7 @@ interface operations {
7700
7596
  };
7701
7597
  };
7702
7598
  };
7703
- "postV1Deposit-destinationsPrepare": {
7599
+ postV1DepositsDirectPrepare: {
7704
7600
  parameters: {
7705
7601
  query?: never;
7706
7602
  header?: never;
@@ -7715,15 +7611,32 @@ interface operations {
7715
7611
  * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7716
7612
  */
7717
7613
  sourceId: string;
7718
- /** @constant */
7719
- network: "solana";
7720
- /** @constant */
7721
- asset: "USDC";
7722
7614
  /**
7723
- * @description Destination wallet address for the selected network
7724
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
7615
+ * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
7616
+ * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
7725
7617
  */
7726
7618
  address: string;
7619
+ /** @enum {string} */
7620
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
7621
+ /**
7622
+ * @description Asset sent to the deposit destination
7623
+ * @example USDC
7624
+ * @constant
7625
+ */
7626
+ asset: "USDC";
7627
+ /** @enum {string} */
7628
+ quoteType: "exact_input" | "exact_output";
7629
+ /**
7630
+ * @description Requested USD amount as a decimal string
7631
+ * @example 100.00
7632
+ */
7633
+ amountUsd: string;
7634
+ /** @enum {string} */
7635
+ priority: "normal" | "high";
7636
+ feeSubsidy?: {
7637
+ percentage: number;
7638
+ maxAmountUsd?: string;
7639
+ };
7727
7640
  clientContext?: {
7728
7641
  clientIp?: string;
7729
7642
  userAgent?: string;
@@ -7739,15 +7652,32 @@ interface operations {
7739
7652
  * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7740
7653
  */
7741
7654
  sourceId: string;
7742
- /** @constant */
7743
- network: "solana";
7744
- /** @constant */
7745
- asset: "USDC";
7746
7655
  /**
7747
- * @description Destination wallet address for the selected network
7748
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
7656
+ * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
7657
+ * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
7749
7658
  */
7750
7659
  address: string;
7660
+ /** @enum {string} */
7661
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
7662
+ /**
7663
+ * @description Asset sent to the deposit destination
7664
+ * @example USDC
7665
+ * @constant
7666
+ */
7667
+ asset: "USDC";
7668
+ /** @enum {string} */
7669
+ quoteType: "exact_input" | "exact_output";
7670
+ /**
7671
+ * @description Requested USD amount as a decimal string
7672
+ * @example 100.00
7673
+ */
7674
+ amountUsd: string;
7675
+ /** @enum {string} */
7676
+ priority: "normal" | "high";
7677
+ feeSubsidy?: {
7678
+ percentage: number;
7679
+ maxAmountUsd?: string;
7680
+ };
7751
7681
  clientContext?: {
7752
7682
  clientIp?: string;
7753
7683
  userAgent?: string;
@@ -7763,15 +7693,32 @@ interface operations {
7763
7693
  * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7764
7694
  */
7765
7695
  sourceId: string;
7766
- /** @constant */
7767
- network: "solana";
7768
- /** @constant */
7769
- asset: "USDC";
7770
7696
  /**
7771
- * @description Destination wallet address for the selected network
7772
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
7697
+ * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
7698
+ * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
7773
7699
  */
7774
7700
  address: string;
7701
+ /** @enum {string} */
7702
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
7703
+ /**
7704
+ * @description Asset sent to the deposit destination
7705
+ * @example USDC
7706
+ * @constant
7707
+ */
7708
+ asset: "USDC";
7709
+ /** @enum {string} */
7710
+ quoteType: "exact_input" | "exact_output";
7711
+ /**
7712
+ * @description Requested USD amount as a decimal string
7713
+ * @example 100.00
7714
+ */
7715
+ amountUsd: string;
7716
+ /** @enum {string} */
7717
+ priority: "normal" | "high";
7718
+ feeSubsidy?: {
7719
+ percentage: number;
7720
+ maxAmountUsd?: string;
7721
+ };
7775
7722
  clientContext?: {
7776
7723
  clientIp?: string;
7777
7724
  userAgent?: string;
@@ -7797,20 +7744,43 @@ interface operations {
7797
7744
  */
7798
7745
  preparationId: string;
7799
7746
  /** @constant */
7800
- kind: "destination_bind";
7747
+ kind: "deposit_authorization";
7801
7748
  /** Format: date-time */
7802
7749
  expiresAt: string;
7803
7750
  /** @constant */
7804
7751
  messageVersion: "v1";
7805
- /** @description Canonical wallet-signable verification message */
7752
+ /** @description Display-ready ACH authorization message */
7806
7753
  message: string;
7807
- /**
7808
- * @description Canonical asset address or mint address for the selected network and asset
7809
- * @example EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
7810
- */
7811
- assetAddress: string;
7812
- /** @description Normalized destination address used in the signed message */
7813
- normalizedAddress: string;
7754
+ summary: {
7755
+ /** @enum {string} */
7756
+ quoteType: "exact_input" | "exact_output";
7757
+ requestedAmountUsd: string;
7758
+ /** @enum {string} */
7759
+ priority: "normal" | "high";
7760
+ feeRateBps: number;
7761
+ principalAmountUsd: string;
7762
+ expectedAssetAmount: string;
7763
+ grossFeeUsd: string;
7764
+ feeSubsidyUsd: string;
7765
+ userFeeUsd: string;
7766
+ totalDebitAmountUsd: string;
7767
+ feeSubsidy: {
7768
+ percentage: number;
7769
+ percentageBps: number;
7770
+ maxAmountUsd: string | null;
7771
+ appliedAmountUsd: string;
7772
+ } | null;
7773
+ /** @enum {string} */
7774
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
7775
+ /**
7776
+ * @description Asset sent to the deposit destination
7777
+ * @example USDC
7778
+ * @constant
7779
+ */
7780
+ asset: "USDC";
7781
+ assetAddress: string;
7782
+ destinationAddress: string;
7783
+ };
7814
7784
  };
7815
7785
  };
7816
7786
  };
@@ -7937,16 +7907,64 @@ interface operations {
7937
7907
  };
7938
7908
  };
7939
7909
  };
7940
- "getV1Deposit-destinations": {
7910
+ postV1DepositsDirect: {
7941
7911
  parameters: {
7942
7912
  query?: never;
7943
7913
  header?: never;
7944
7914
  path?: never;
7945
7915
  cookie?: never;
7946
7916
  };
7947
- requestBody?: never;
7917
+ requestBody: {
7918
+ content: {
7919
+ "application/json": {
7920
+ /**
7921
+ * @description Opaque public preparation identifier returned by direct prepare
7922
+ * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7923
+ */
7924
+ preparationId: string;
7925
+ clientContext?: {
7926
+ clientIp?: string;
7927
+ userAgent?: string;
7928
+ sessionId?: string;
7929
+ deviceId?: string;
7930
+ platform?: string;
7931
+ appVersion?: string;
7932
+ };
7933
+ };
7934
+ "application/x-www-form-urlencoded": {
7935
+ /**
7936
+ * @description Opaque public preparation identifier returned by direct prepare
7937
+ * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7938
+ */
7939
+ preparationId: string;
7940
+ clientContext?: {
7941
+ clientIp?: string;
7942
+ userAgent?: string;
7943
+ sessionId?: string;
7944
+ deviceId?: string;
7945
+ platform?: string;
7946
+ appVersion?: string;
7947
+ };
7948
+ };
7949
+ "multipart/form-data": {
7950
+ /**
7951
+ * @description Opaque public preparation identifier returned by direct prepare
7952
+ * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7953
+ */
7954
+ preparationId: string;
7955
+ clientContext?: {
7956
+ clientIp?: string;
7957
+ userAgent?: string;
7958
+ sessionId?: string;
7959
+ deviceId?: string;
7960
+ platform?: string;
7961
+ appVersion?: string;
7962
+ };
7963
+ };
7964
+ };
7965
+ };
7948
7966
  responses: {
7949
- /** @description Response for status 200 */
7967
+ /** @description An ACH debit deposit authorized by the user and processed asynchronously through debit and crypto release lifecycles. */
7950
7968
  200: {
7951
7969
  headers: {
7952
7970
  [name: string]: unknown;
@@ -7954,8 +7972,8 @@ interface operations {
7954
7972
  content: {
7955
7973
  "application/json": {
7956
7974
  /**
7957
- * @description Opaque public identifier for the deposit destination
7958
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7975
+ * @description Opaque public deposit identifier
7976
+ * @example dep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7959
7977
  */
7960
7978
  id: string;
7961
7979
  /**
@@ -7963,1334 +7981,6 @@ interface operations {
7963
7981
  * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
7964
7982
  */
7965
7983
  sourceId: string;
7966
- /**
7967
- * @description Blockchain network for the bound deposit destination
7968
- * @example solana
7969
- * @constant
7970
- */
7971
- network: "solana";
7972
- /**
7973
- * @description Asset sent to the deposit destination
7974
- * @example USDC
7975
- * @constant
7976
- */
7977
- asset: "USDC";
7978
- /**
7979
- * @description Canonical asset address or mint address for the selected network and asset
7980
- * @example EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
7981
- */
7982
- assetAddress: string;
7983
- /** @description Bound wallet destination address */
7984
- address: string;
7985
- /** @enum {string} */
7986
- status: "active" | "revoked";
7987
- /**
7988
- * Format: date-time
7989
- * @description When the destination was created
7990
- */
7991
- createdAt: string;
7992
- /** @description When the destination was revoked, or null when active */
7993
- revokedAt: string | null;
7994
- }[];
7995
- };
7996
- };
7997
- /** @description Response for status 401 */
7998
- 401: {
7999
- headers: {
8000
- [name: string]: unknown;
8001
- };
8002
- content: {
8003
- "application/json": {
8004
- /**
8005
- * @description A URI reference that identifies the problem type
8006
- * @default about:blank
8007
- * @example urn:problem-type:auth:unauthorized
8008
- * @example urn:problem-type:auth:token-expired
8009
- */
8010
- type: string;
8011
- /**
8012
- * @description A short, human-readable summary of the problem type
8013
- * @example Unauthorized
8014
- * @example Token Expired
8015
- */
8016
- title: string;
8017
- /**
8018
- * @description The HTTP status code
8019
- * @example 401
8020
- * @example 403
8021
- */
8022
- status: number;
8023
- /**
8024
- * @description A human-readable explanation specific to this occurrence
8025
- * @example Bearer token required
8026
- * @example Invalid token
8027
- */
8028
- detail?: string;
8029
- /** @description A URI reference that identifies the specific occurrence */
8030
- instance?: string;
8031
- /**
8032
- * @description The authentication realm
8033
- * @example API
8034
- */
8035
- realm?: string;
8036
- /**
8037
- * @description The required scope for this resource
8038
- * @example read:users
8039
- * @example write:orders
8040
- */
8041
- scope?: string;
8042
- };
8043
- };
8044
- };
8045
- /** @description Response for status 404 */
8046
- 404: {
8047
- headers: {
8048
- [name: string]: unknown;
8049
- };
8050
- content: {
8051
- "application/json": {
8052
- /**
8053
- * @description A URI reference that identifies the problem type
8054
- * @default about:blank
8055
- */
8056
- type: string;
8057
- /** @description A short, human-readable summary of the problem type */
8058
- title: string;
8059
- /**
8060
- * @description The HTTP status code
8061
- * @example 404
8062
- */
8063
- status: number;
8064
- /** @description A human-readable explanation specific to this occurrence */
8065
- detail?: string;
8066
- /** @description A URI reference that identifies the specific occurrence */
8067
- instance?: string;
8068
- /**
8069
- * @description The type of resource that was not found
8070
- * @example user
8071
- * @example account
8072
- * @example transaction
8073
- */
8074
- resourceType: string;
8075
- /** @description The identifier of the resource that was not found */
8076
- resourceId: string;
8077
- };
8078
- };
8079
- };
8080
- /** @description Response for status 500 */
8081
- 500: {
8082
- headers: {
8083
- [name: string]: unknown;
8084
- };
8085
- content: {
8086
- "application/json": {
8087
- /**
8088
- * @description A URI reference that identifies the problem type
8089
- * @default about:blank
8090
- * @example urn:problem-type:auth:unauthorized
8091
- * @example urn:problem-type:system:internal-error
8092
- */
8093
- type: string;
8094
- /**
8095
- * @description A short, human-readable summary of the problem type
8096
- * @example Unauthorized
8097
- * @example Internal Server Error
8098
- */
8099
- title: string;
8100
- /**
8101
- * @description The HTTP status code
8102
- * @example 400
8103
- * @example 401
8104
- * @example 404
8105
- * @example 500
8106
- */
8107
- status: number;
8108
- /** @description A human-readable explanation specific to this occurrence */
8109
- detail?: string;
8110
- /**
8111
- * @description A URI reference that identifies the specific occurrence
8112
- * @example /errors/1234567890
8113
- */
8114
- instance?: string;
8115
- };
8116
- };
8117
- };
8118
- };
8119
- };
8120
- "postV1Deposit-destinations": {
8121
- parameters: {
8122
- query?: never;
8123
- header?: never;
8124
- path?: never;
8125
- cookie?: never;
8126
- };
8127
- requestBody: {
8128
- content: {
8129
- "application/json": {
8130
- /**
8131
- * @description Opaque public preparation identifier returned by prepare
8132
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8133
- */
8134
- preparationId: string;
8135
- /** @description Ed25519 signature over the exact message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8136
- signature: string;
8137
- /**
8138
- * @description Wallet address that produced the signature
8139
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
8140
- */
8141
- signerAddress: string;
8142
- clientContext?: {
8143
- clientIp?: string;
8144
- userAgent?: string;
8145
- sessionId?: string;
8146
- deviceId?: string;
8147
- platform?: string;
8148
- appVersion?: string;
8149
- };
8150
- };
8151
- "application/x-www-form-urlencoded": {
8152
- /**
8153
- * @description Opaque public preparation identifier returned by prepare
8154
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8155
- */
8156
- preparationId: string;
8157
- /** @description Ed25519 signature over the exact message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8158
- signature: string;
8159
- /**
8160
- * @description Wallet address that produced the signature
8161
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
8162
- */
8163
- signerAddress: string;
8164
- clientContext?: {
8165
- clientIp?: string;
8166
- userAgent?: string;
8167
- sessionId?: string;
8168
- deviceId?: string;
8169
- platform?: string;
8170
- appVersion?: string;
8171
- };
8172
- };
8173
- "multipart/form-data": {
8174
- /**
8175
- * @description Opaque public preparation identifier returned by prepare
8176
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8177
- */
8178
- preparationId: string;
8179
- /** @description Ed25519 signature over the exact message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8180
- signature: string;
8181
- /**
8182
- * @description Wallet address that produced the signature
8183
- * @example 9xQeWvG816bUx9EPjHmaT23yvVM3qvGqLrL7Kx1YwM9R
8184
- */
8185
- signerAddress: string;
8186
- clientContext?: {
8187
- clientIp?: string;
8188
- userAgent?: string;
8189
- sessionId?: string;
8190
- deviceId?: string;
8191
- platform?: string;
8192
- appVersion?: string;
8193
- };
8194
- };
8195
- };
8196
- };
8197
- responses: {
8198
- /** @description A wallet destination bound to a funding source for future on-ramp deposits */
8199
- 200: {
8200
- headers: {
8201
- [name: string]: unknown;
8202
- };
8203
- content: {
8204
- "application/json": {
8205
- /**
8206
- * @description Opaque public identifier for the deposit destination
8207
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8208
- */
8209
- id: string;
8210
- /**
8211
- * @description Opaque public funding source identifier
8212
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8213
- */
8214
- sourceId: string;
8215
- /**
8216
- * @description Blockchain network for the bound deposit destination
8217
- * @example solana
8218
- * @constant
8219
- */
8220
- network: "solana";
8221
- /**
8222
- * @description Asset sent to the deposit destination
8223
- * @example USDC
8224
- * @constant
8225
- */
8226
- asset: "USDC";
8227
- /**
8228
- * @description Canonical asset address or mint address for the selected network and asset
8229
- * @example EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
8230
- */
8231
- assetAddress: string;
8232
- /** @description Bound wallet destination address */
8233
- address: string;
8234
- /** @enum {string} */
8235
- status: "active" | "revoked";
8236
- /**
8237
- * Format: date-time
8238
- * @description When the destination was created
8239
- */
8240
- createdAt: string;
8241
- /** @description When the destination was revoked, or null when active */
8242
- revokedAt: string | null;
8243
- };
8244
- };
8245
- };
8246
- /** @description Response for status 401 */
8247
- 401: {
8248
- headers: {
8249
- [name: string]: unknown;
8250
- };
8251
- content: {
8252
- "application/json": {
8253
- /**
8254
- * @description A URI reference that identifies the problem type
8255
- * @default about:blank
8256
- * @example urn:problem-type:auth:unauthorized
8257
- * @example urn:problem-type:auth:token-expired
8258
- */
8259
- type: string;
8260
- /**
8261
- * @description A short, human-readable summary of the problem type
8262
- * @example Unauthorized
8263
- * @example Token Expired
8264
- */
8265
- title: string;
8266
- /**
8267
- * @description The HTTP status code
8268
- * @example 401
8269
- * @example 403
8270
- */
8271
- status: number;
8272
- /**
8273
- * @description A human-readable explanation specific to this occurrence
8274
- * @example Bearer token required
8275
- * @example Invalid token
8276
- */
8277
- detail?: string;
8278
- /** @description A URI reference that identifies the specific occurrence */
8279
- instance?: string;
8280
- /**
8281
- * @description The authentication realm
8282
- * @example API
8283
- */
8284
- realm?: string;
8285
- /**
8286
- * @description The required scope for this resource
8287
- * @example read:users
8288
- * @example write:orders
8289
- */
8290
- scope?: string;
8291
- };
8292
- };
8293
- };
8294
- /** @description Response for status 404 */
8295
- 404: {
8296
- headers: {
8297
- [name: string]: unknown;
8298
- };
8299
- content: {
8300
- "application/json": {
8301
- /**
8302
- * @description A URI reference that identifies the problem type
8303
- * @default about:blank
8304
- */
8305
- type: string;
8306
- /** @description A short, human-readable summary of the problem type */
8307
- title: string;
8308
- /**
8309
- * @description The HTTP status code
8310
- * @example 404
8311
- */
8312
- status: number;
8313
- /** @description A human-readable explanation specific to this occurrence */
8314
- detail?: string;
8315
- /** @description A URI reference that identifies the specific occurrence */
8316
- instance?: string;
8317
- /**
8318
- * @description The type of resource that was not found
8319
- * @example user
8320
- * @example account
8321
- * @example transaction
8322
- */
8323
- resourceType: string;
8324
- /** @description The identifier of the resource that was not found */
8325
- resourceId: string;
8326
- };
8327
- };
8328
- };
8329
- /** @description Response for status 500 */
8330
- 500: {
8331
- headers: {
8332
- [name: string]: unknown;
8333
- };
8334
- content: {
8335
- "application/json": {
8336
- /**
8337
- * @description A URI reference that identifies the problem type
8338
- * @default about:blank
8339
- * @example urn:problem-type:auth:unauthorized
8340
- * @example urn:problem-type:system:internal-error
8341
- */
8342
- type: string;
8343
- /**
8344
- * @description A short, human-readable summary of the problem type
8345
- * @example Unauthorized
8346
- * @example Internal Server Error
8347
- */
8348
- title: string;
8349
- /**
8350
- * @description The HTTP status code
8351
- * @example 400
8352
- * @example 401
8353
- * @example 404
8354
- * @example 500
8355
- */
8356
- status: number;
8357
- /** @description A human-readable explanation specific to this occurrence */
8358
- detail?: string;
8359
- /**
8360
- * @description A URI reference that identifies the specific occurrence
8361
- * @example /errors/1234567890
8362
- */
8363
- instance?: string;
8364
- };
8365
- };
8366
- };
8367
- };
8368
- };
8369
- postV1DepositsPrepare: {
8370
- parameters: {
8371
- query?: never;
8372
- header?: never;
8373
- path?: never;
8374
- cookie?: never;
8375
- };
8376
- requestBody: {
8377
- content: {
8378
- "application/json": {
8379
- /**
8380
- * @description Opaque public funding source identifier
8381
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8382
- */
8383
- sourceId: string;
8384
- /**
8385
- * @description Opaque public deposit destination identifier
8386
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8387
- */
8388
- destinationId: string;
8389
- /** @enum {string} */
8390
- quoteType: "exact_input" | "exact_output";
8391
- /**
8392
- * @description Requested USD amount as a decimal string
8393
- * @example 100.00
8394
- */
8395
- amountUsd: string;
8396
- /** @enum {string} */
8397
- priority: "normal" | "high";
8398
- feeSubsidy?: {
8399
- percentage: number;
8400
- maxAmountUsd?: string;
8401
- };
8402
- clientContext?: {
8403
- clientIp?: string;
8404
- userAgent?: string;
8405
- sessionId?: string;
8406
- deviceId?: string;
8407
- platform?: string;
8408
- appVersion?: string;
8409
- };
8410
- };
8411
- "application/x-www-form-urlencoded": {
8412
- /**
8413
- * @description Opaque public funding source identifier
8414
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8415
- */
8416
- sourceId: string;
8417
- /**
8418
- * @description Opaque public deposit destination identifier
8419
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8420
- */
8421
- destinationId: string;
8422
- /** @enum {string} */
8423
- quoteType: "exact_input" | "exact_output";
8424
- /**
8425
- * @description Requested USD amount as a decimal string
8426
- * @example 100.00
8427
- */
8428
- amountUsd: string;
8429
- /** @enum {string} */
8430
- priority: "normal" | "high";
8431
- feeSubsidy?: {
8432
- percentage: number;
8433
- maxAmountUsd?: string;
8434
- };
8435
- clientContext?: {
8436
- clientIp?: string;
8437
- userAgent?: string;
8438
- sessionId?: string;
8439
- deviceId?: string;
8440
- platform?: string;
8441
- appVersion?: string;
8442
- };
8443
- };
8444
- "multipart/form-data": {
8445
- /**
8446
- * @description Opaque public funding source identifier
8447
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8448
- */
8449
- sourceId: string;
8450
- /**
8451
- * @description Opaque public deposit destination identifier
8452
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8453
- */
8454
- destinationId: string;
8455
- /** @enum {string} */
8456
- quoteType: "exact_input" | "exact_output";
8457
- /**
8458
- * @description Requested USD amount as a decimal string
8459
- * @example 100.00
8460
- */
8461
- amountUsd: string;
8462
- /** @enum {string} */
8463
- priority: "normal" | "high";
8464
- feeSubsidy?: {
8465
- percentage: number;
8466
- maxAmountUsd?: string;
8467
- };
8468
- clientContext?: {
8469
- clientIp?: string;
8470
- userAgent?: string;
8471
- sessionId?: string;
8472
- deviceId?: string;
8473
- platform?: string;
8474
- appVersion?: string;
8475
- };
8476
- };
8477
- };
8478
- };
8479
- responses: {
8480
- /** @description Response for status 200 */
8481
- 200: {
8482
- headers: {
8483
- [name: string]: unknown;
8484
- };
8485
- content: {
8486
- "application/json": {
8487
- /**
8488
- * @description Opaque public preparation identifier
8489
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8490
- */
8491
- preparationId: string;
8492
- /** @constant */
8493
- kind: "deposit_authorization";
8494
- /** Format: date-time */
8495
- expiresAt: string;
8496
- /** @constant */
8497
- messageVersion: "v1";
8498
- /** @description Display-ready ACH authorization message */
8499
- message: string;
8500
- summary: {
8501
- /** @enum {string} */
8502
- quoteType: "exact_input" | "exact_output";
8503
- requestedAmountUsd: string;
8504
- /** @enum {string} */
8505
- priority: "normal" | "high";
8506
- feeRateBps: number;
8507
- principalAmountUsd: string;
8508
- expectedAssetAmount: string;
8509
- grossFeeUsd: string;
8510
- feeSubsidyUsd: string;
8511
- userFeeUsd: string;
8512
- totalDebitAmountUsd: string;
8513
- feeSubsidy: {
8514
- percentage: number;
8515
- percentageBps: number;
8516
- maxAmountUsd: string | null;
8517
- appliedAmountUsd: string;
8518
- } | null;
8519
- /** @constant */
8520
- network: "solana";
8521
- /** @constant */
8522
- asset: "USDC";
8523
- assetAddress: string;
8524
- destinationAddress: string;
8525
- };
8526
- };
8527
- };
8528
- };
8529
- /** @description Response for status 401 */
8530
- 401: {
8531
- headers: {
8532
- [name: string]: unknown;
8533
- };
8534
- content: {
8535
- "application/json": {
8536
- /**
8537
- * @description A URI reference that identifies the problem type
8538
- * @default about:blank
8539
- * @example urn:problem-type:auth:unauthorized
8540
- * @example urn:problem-type:auth:token-expired
8541
- */
8542
- type: string;
8543
- /**
8544
- * @description A short, human-readable summary of the problem type
8545
- * @example Unauthorized
8546
- * @example Token Expired
8547
- */
8548
- title: string;
8549
- /**
8550
- * @description The HTTP status code
8551
- * @example 401
8552
- * @example 403
8553
- */
8554
- status: number;
8555
- /**
8556
- * @description A human-readable explanation specific to this occurrence
8557
- * @example Bearer token required
8558
- * @example Invalid token
8559
- */
8560
- detail?: string;
8561
- /** @description A URI reference that identifies the specific occurrence */
8562
- instance?: string;
8563
- /**
8564
- * @description The authentication realm
8565
- * @example API
8566
- */
8567
- realm?: string;
8568
- /**
8569
- * @description The required scope for this resource
8570
- * @example read:users
8571
- * @example write:orders
8572
- */
8573
- scope?: string;
8574
- };
8575
- };
8576
- };
8577
- /** @description Response for status 404 */
8578
- 404: {
8579
- headers: {
8580
- [name: string]: unknown;
8581
- };
8582
- content: {
8583
- "application/json": {
8584
- /**
8585
- * @description A URI reference that identifies the problem type
8586
- * @default about:blank
8587
- */
8588
- type: string;
8589
- /** @description A short, human-readable summary of the problem type */
8590
- title: string;
8591
- /**
8592
- * @description The HTTP status code
8593
- * @example 404
8594
- */
8595
- status: number;
8596
- /** @description A human-readable explanation specific to this occurrence */
8597
- detail?: string;
8598
- /** @description A URI reference that identifies the specific occurrence */
8599
- instance?: string;
8600
- /**
8601
- * @description The type of resource that was not found
8602
- * @example user
8603
- * @example account
8604
- * @example transaction
8605
- */
8606
- resourceType: string;
8607
- /** @description The identifier of the resource that was not found */
8608
- resourceId: string;
8609
- };
8610
- };
8611
- };
8612
- /** @description Response for status 500 */
8613
- 500: {
8614
- headers: {
8615
- [name: string]: unknown;
8616
- };
8617
- content: {
8618
- "application/json": {
8619
- /**
8620
- * @description A URI reference that identifies the problem type
8621
- * @default about:blank
8622
- * @example urn:problem-type:auth:unauthorized
8623
- * @example urn:problem-type:system:internal-error
8624
- */
8625
- type: string;
8626
- /**
8627
- * @description A short, human-readable summary of the problem type
8628
- * @example Unauthorized
8629
- * @example Internal Server Error
8630
- */
8631
- title: string;
8632
- /**
8633
- * @description The HTTP status code
8634
- * @example 400
8635
- * @example 401
8636
- * @example 404
8637
- * @example 500
8638
- */
8639
- status: number;
8640
- /** @description A human-readable explanation specific to this occurrence */
8641
- detail?: string;
8642
- /**
8643
- * @description A URI reference that identifies the specific occurrence
8644
- * @example /errors/1234567890
8645
- */
8646
- instance?: string;
8647
- };
8648
- };
8649
- };
8650
- };
8651
- };
8652
- postV1Deposits: {
8653
- parameters: {
8654
- query?: never;
8655
- header?: never;
8656
- path?: never;
8657
- cookie?: never;
8658
- };
8659
- requestBody: {
8660
- content: {
8661
- "application/json": {
8662
- /**
8663
- * @description Opaque public preparation identifier returned by prepare
8664
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8665
- */
8666
- preparationId: string;
8667
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8668
- signature: string;
8669
- clientContext?: {
8670
- clientIp?: string;
8671
- userAgent?: string;
8672
- sessionId?: string;
8673
- deviceId?: string;
8674
- platform?: string;
8675
- appVersion?: string;
8676
- };
8677
- };
8678
- "application/x-www-form-urlencoded": {
8679
- /**
8680
- * @description Opaque public preparation identifier returned by prepare
8681
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8682
- */
8683
- preparationId: string;
8684
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8685
- signature: string;
8686
- clientContext?: {
8687
- clientIp?: string;
8688
- userAgent?: string;
8689
- sessionId?: string;
8690
- deviceId?: string;
8691
- platform?: string;
8692
- appVersion?: string;
8693
- };
8694
- };
8695
- "multipart/form-data": {
8696
- /**
8697
- * @description Opaque public preparation identifier returned by prepare
8698
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8699
- */
8700
- preparationId: string;
8701
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
8702
- signature: string;
8703
- clientContext?: {
8704
- clientIp?: string;
8705
- userAgent?: string;
8706
- sessionId?: string;
8707
- deviceId?: string;
8708
- platform?: string;
8709
- appVersion?: string;
8710
- };
8711
- };
8712
- };
8713
- };
8714
- responses: {
8715
- /** @description An ACH debit deposit authorized by the user and processed asynchronously through debit and crypto release lifecycles. */
8716
- 200: {
8717
- headers: {
8718
- [name: string]: unknown;
8719
- };
8720
- content: {
8721
- "application/json": {
8722
- /**
8723
- * @description Opaque public deposit identifier
8724
- * @example dep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8725
- */
8726
- id: string;
8727
- /**
8728
- * @description Opaque public funding source identifier
8729
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8730
- */
8731
- sourceId: string;
8732
- /**
8733
- * @description Opaque public deposit destination identifier
8734
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8735
- */
8736
- destinationId: string;
8737
- /** @enum {string} */
8738
- status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
8739
- /** @enum {string} */
8740
- quoteType: "exact_input" | "exact_output";
8741
- /** @enum {string} */
8742
- priority: "normal" | "high";
8743
- feeRateBps: number;
8744
- principalAmountUsd: string;
8745
- expectedAssetAmount: string;
8746
- grossFeeUsd: string;
8747
- feeSubsidyUsd: string;
8748
- userFeeUsd: string;
8749
- totalDebitAmountUsd: string;
8750
- feeSubsidy: {
8751
- percentage: number;
8752
- percentageBps: number;
8753
- maxAmountUsd: string | null;
8754
- appliedAmountUsd: string;
8755
- } | null;
8756
- /**
8757
- * @description Blockchain network for the bound deposit destination
8758
- * @example solana
8759
- * @constant
8760
- */
8761
- network: "solana";
8762
- /**
8763
- * @description Asset sent to the deposit destination
8764
- * @example USDC
8765
- * @constant
8766
- */
8767
- asset: "USDC";
8768
- assetAddress: string;
8769
- /** @description Destination wallet address for the crypto release */
8770
- address: string;
8771
- /** @enum {string} */
8772
- debitStatus: "authorized" | "submitting" | "submitted" | "settled" | "returned" | "failed";
8773
- /** @enum {string} */
8774
- releaseStatus: "not_started" | "queued" | "partial" | "completed" | "failed";
8775
- /** @enum {string} */
8776
- releaseDecisionMode: "after_settlement" | "early_full" | "early_partial";
8777
- releasedAmountUsd: string;
8778
- confirmedReleasedAmountUsd: string;
8779
- exposureAmountUsd: string;
8780
- /** Format: date-time */
8781
- authorizedAt: string;
8782
- /** Format: date-time */
8783
- createdAt: string;
8784
- settledAt: string | null;
8785
- returnedAt: string | null;
8786
- completedAt: string | null;
8787
- returnCode: string | null;
8788
- returnReason: string | null;
8789
- debitFailureCode: string | null;
8790
- debitFailureReason: string | null;
8791
- releaseFailureCode: string | null;
8792
- releaseFailureReason: string | null;
8793
- payoutTxHash: string | null;
8794
- };
8795
- };
8796
- };
8797
- /** @description Response for status 401 */
8798
- 401: {
8799
- headers: {
8800
- [name: string]: unknown;
8801
- };
8802
- content: {
8803
- "application/json": {
8804
- /**
8805
- * @description A URI reference that identifies the problem type
8806
- * @default about:blank
8807
- * @example urn:problem-type:auth:unauthorized
8808
- * @example urn:problem-type:auth:token-expired
8809
- */
8810
- type: string;
8811
- /**
8812
- * @description A short, human-readable summary of the problem type
8813
- * @example Unauthorized
8814
- * @example Token Expired
8815
- */
8816
- title: string;
8817
- /**
8818
- * @description The HTTP status code
8819
- * @example 401
8820
- * @example 403
8821
- */
8822
- status: number;
8823
- /**
8824
- * @description A human-readable explanation specific to this occurrence
8825
- * @example Bearer token required
8826
- * @example Invalid token
8827
- */
8828
- detail?: string;
8829
- /** @description A URI reference that identifies the specific occurrence */
8830
- instance?: string;
8831
- /**
8832
- * @description The authentication realm
8833
- * @example API
8834
- */
8835
- realm?: string;
8836
- /**
8837
- * @description The required scope for this resource
8838
- * @example read:users
8839
- * @example write:orders
8840
- */
8841
- scope?: string;
8842
- };
8843
- };
8844
- };
8845
- /** @description Response for status 404 */
8846
- 404: {
8847
- headers: {
8848
- [name: string]: unknown;
8849
- };
8850
- content: {
8851
- "application/json": {
8852
- /**
8853
- * @description A URI reference that identifies the problem type
8854
- * @default about:blank
8855
- */
8856
- type: string;
8857
- /** @description A short, human-readable summary of the problem type */
8858
- title: string;
8859
- /**
8860
- * @description The HTTP status code
8861
- * @example 404
8862
- */
8863
- status: number;
8864
- /** @description A human-readable explanation specific to this occurrence */
8865
- detail?: string;
8866
- /** @description A URI reference that identifies the specific occurrence */
8867
- instance?: string;
8868
- /**
8869
- * @description The type of resource that was not found
8870
- * @example user
8871
- * @example account
8872
- * @example transaction
8873
- */
8874
- resourceType: string;
8875
- /** @description The identifier of the resource that was not found */
8876
- resourceId: string;
8877
- };
8878
- };
8879
- };
8880
- /** @description Response for status 500 */
8881
- 500: {
8882
- headers: {
8883
- [name: string]: unknown;
8884
- };
8885
- content: {
8886
- "application/json": {
8887
- /**
8888
- * @description A URI reference that identifies the problem type
8889
- * @default about:blank
8890
- * @example urn:problem-type:auth:unauthorized
8891
- * @example urn:problem-type:system:internal-error
8892
- */
8893
- type: string;
8894
- /**
8895
- * @description A short, human-readable summary of the problem type
8896
- * @example Unauthorized
8897
- * @example Internal Server Error
8898
- */
8899
- title: string;
8900
- /**
8901
- * @description The HTTP status code
8902
- * @example 400
8903
- * @example 401
8904
- * @example 404
8905
- * @example 500
8906
- */
8907
- status: number;
8908
- /** @description A human-readable explanation specific to this occurrence */
8909
- detail?: string;
8910
- /**
8911
- * @description A URI reference that identifies the specific occurrence
8912
- * @example /errors/1234567890
8913
- */
8914
- instance?: string;
8915
- };
8916
- };
8917
- };
8918
- };
8919
- };
8920
- postV1DepositsDirectPrepare: {
8921
- parameters: {
8922
- query?: never;
8923
- header?: never;
8924
- path?: never;
8925
- cookie?: never;
8926
- };
8927
- requestBody: {
8928
- content: {
8929
- "application/json": {
8930
- /**
8931
- * @description Opaque public funding source identifier
8932
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8933
- */
8934
- sourceId: string;
8935
- /**
8936
- * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
8937
- * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
8938
- */
8939
- address: string;
8940
- /** @constant */
8941
- network: "solana";
8942
- /** @constant */
8943
- asset: "USDC";
8944
- /** @enum {string} */
8945
- quoteType: "exact_input" | "exact_output";
8946
- /**
8947
- * @description Requested USD amount as a decimal string
8948
- * @example 100.00
8949
- */
8950
- amountUsd: string;
8951
- /** @enum {string} */
8952
- priority: "normal" | "high";
8953
- feeSubsidy?: {
8954
- percentage: number;
8955
- maxAmountUsd?: string;
8956
- };
8957
- clientContext?: {
8958
- clientIp?: string;
8959
- userAgent?: string;
8960
- sessionId?: string;
8961
- deviceId?: string;
8962
- platform?: string;
8963
- appVersion?: string;
8964
- };
8965
- };
8966
- "application/x-www-form-urlencoded": {
8967
- /**
8968
- * @description Opaque public funding source identifier
8969
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
8970
- */
8971
- sourceId: string;
8972
- /**
8973
- * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
8974
- * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
8975
- */
8976
- address: string;
8977
- /** @constant */
8978
- network: "solana";
8979
- /** @constant */
8980
- asset: "USDC";
8981
- /** @enum {string} */
8982
- quoteType: "exact_input" | "exact_output";
8983
- /**
8984
- * @description Requested USD amount as a decimal string
8985
- * @example 100.00
8986
- */
8987
- amountUsd: string;
8988
- /** @enum {string} */
8989
- priority: "normal" | "high";
8990
- feeSubsidy?: {
8991
- percentage: number;
8992
- maxAmountUsd?: string;
8993
- };
8994
- clientContext?: {
8995
- clientIp?: string;
8996
- userAgent?: string;
8997
- sessionId?: string;
8998
- deviceId?: string;
8999
- platform?: string;
9000
- appVersion?: string;
9001
- };
9002
- };
9003
- "multipart/form-data": {
9004
- /**
9005
- * @description Opaque public funding source identifier
9006
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9007
- */
9008
- sourceId: string;
9009
- /**
9010
- * @description Destination wallet address to deposit into. Validated but not proven via wallet signature; authorization is derived from the verified ACH funding source.
9011
- * @example 9n4nbM75f5Ui33ZbPYXn59EwSb9Y1zdyu3x2b1f8jQRY
9012
- */
9013
- address: string;
9014
- /** @constant */
9015
- network: "solana";
9016
- /** @constant */
9017
- asset: "USDC";
9018
- /** @enum {string} */
9019
- quoteType: "exact_input" | "exact_output";
9020
- /**
9021
- * @description Requested USD amount as a decimal string
9022
- * @example 100.00
9023
- */
9024
- amountUsd: string;
9025
- /** @enum {string} */
9026
- priority: "normal" | "high";
9027
- feeSubsidy?: {
9028
- percentage: number;
9029
- maxAmountUsd?: string;
9030
- };
9031
- clientContext?: {
9032
- clientIp?: string;
9033
- userAgent?: string;
9034
- sessionId?: string;
9035
- deviceId?: string;
9036
- platform?: string;
9037
- appVersion?: string;
9038
- };
9039
- };
9040
- };
9041
- };
9042
- responses: {
9043
- /** @description Response for status 200 */
9044
- 200: {
9045
- headers: {
9046
- [name: string]: unknown;
9047
- };
9048
- content: {
9049
- "application/json": {
9050
- /**
9051
- * @description Opaque public preparation identifier
9052
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9053
- */
9054
- preparationId: string;
9055
- /** @constant */
9056
- kind: "deposit_authorization";
9057
- /** Format: date-time */
9058
- expiresAt: string;
9059
- /** @constant */
9060
- messageVersion: "v1";
9061
- /** @description Display-ready ACH authorization message */
9062
- message: string;
9063
- summary: {
9064
- /** @enum {string} */
9065
- quoteType: "exact_input" | "exact_output";
9066
- requestedAmountUsd: string;
9067
- /** @enum {string} */
9068
- priority: "normal" | "high";
9069
- feeRateBps: number;
9070
- principalAmountUsd: string;
9071
- expectedAssetAmount: string;
9072
- grossFeeUsd: string;
9073
- feeSubsidyUsd: string;
9074
- userFeeUsd: string;
9075
- totalDebitAmountUsd: string;
9076
- feeSubsidy: {
9077
- percentage: number;
9078
- percentageBps: number;
9079
- maxAmountUsd: string | null;
9080
- appliedAmountUsd: string;
9081
- } | null;
9082
- /** @constant */
9083
- network: "solana";
9084
- /** @constant */
9085
- asset: "USDC";
9086
- assetAddress: string;
9087
- destinationAddress: string;
9088
- };
9089
- };
9090
- };
9091
- };
9092
- /** @description Response for status 401 */
9093
- 401: {
9094
- headers: {
9095
- [name: string]: unknown;
9096
- };
9097
- content: {
9098
- "application/json": {
9099
- /**
9100
- * @description A URI reference that identifies the problem type
9101
- * @default about:blank
9102
- * @example urn:problem-type:auth:unauthorized
9103
- * @example urn:problem-type:auth:token-expired
9104
- */
9105
- type: string;
9106
- /**
9107
- * @description A short, human-readable summary of the problem type
9108
- * @example Unauthorized
9109
- * @example Token Expired
9110
- */
9111
- title: string;
9112
- /**
9113
- * @description The HTTP status code
9114
- * @example 401
9115
- * @example 403
9116
- */
9117
- status: number;
9118
- /**
9119
- * @description A human-readable explanation specific to this occurrence
9120
- * @example Bearer token required
9121
- * @example Invalid token
9122
- */
9123
- detail?: string;
9124
- /** @description A URI reference that identifies the specific occurrence */
9125
- instance?: string;
9126
- /**
9127
- * @description The authentication realm
9128
- * @example API
9129
- */
9130
- realm?: string;
9131
- /**
9132
- * @description The required scope for this resource
9133
- * @example read:users
9134
- * @example write:orders
9135
- */
9136
- scope?: string;
9137
- };
9138
- };
9139
- };
9140
- /** @description Response for status 404 */
9141
- 404: {
9142
- headers: {
9143
- [name: string]: unknown;
9144
- };
9145
- content: {
9146
- "application/json": {
9147
- /**
9148
- * @description A URI reference that identifies the problem type
9149
- * @default about:blank
9150
- */
9151
- type: string;
9152
- /** @description A short, human-readable summary of the problem type */
9153
- title: string;
9154
- /**
9155
- * @description The HTTP status code
9156
- * @example 404
9157
- */
9158
- status: number;
9159
- /** @description A human-readable explanation specific to this occurrence */
9160
- detail?: string;
9161
- /** @description A URI reference that identifies the specific occurrence */
9162
- instance?: string;
9163
- /**
9164
- * @description The type of resource that was not found
9165
- * @example user
9166
- * @example account
9167
- * @example transaction
9168
- */
9169
- resourceType: string;
9170
- /** @description The identifier of the resource that was not found */
9171
- resourceId: string;
9172
- };
9173
- };
9174
- };
9175
- /** @description Response for status 500 */
9176
- 500: {
9177
- headers: {
9178
- [name: string]: unknown;
9179
- };
9180
- content: {
9181
- "application/json": {
9182
- /**
9183
- * @description A URI reference that identifies the problem type
9184
- * @default about:blank
9185
- * @example urn:problem-type:auth:unauthorized
9186
- * @example urn:problem-type:system:internal-error
9187
- */
9188
- type: string;
9189
- /**
9190
- * @description A short, human-readable summary of the problem type
9191
- * @example Unauthorized
9192
- * @example Internal Server Error
9193
- */
9194
- title: string;
9195
- /**
9196
- * @description The HTTP status code
9197
- * @example 400
9198
- * @example 401
9199
- * @example 404
9200
- * @example 500
9201
- */
9202
- status: number;
9203
- /** @description A human-readable explanation specific to this occurrence */
9204
- detail?: string;
9205
- /**
9206
- * @description A URI reference that identifies the specific occurrence
9207
- * @example /errors/1234567890
9208
- */
9209
- instance?: string;
9210
- };
9211
- };
9212
- };
9213
- };
9214
- };
9215
- postV1DepositsDirect: {
9216
- parameters: {
9217
- query?: never;
9218
- header?: never;
9219
- path?: never;
9220
- cookie?: never;
9221
- };
9222
- requestBody: {
9223
- content: {
9224
- "application/json": {
9225
- /**
9226
- * @description Opaque public preparation identifier returned by direct prepare
9227
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9228
- */
9229
- preparationId: string;
9230
- clientContext?: {
9231
- clientIp?: string;
9232
- userAgent?: string;
9233
- sessionId?: string;
9234
- deviceId?: string;
9235
- platform?: string;
9236
- appVersion?: string;
9237
- };
9238
- };
9239
- "application/x-www-form-urlencoded": {
9240
- /**
9241
- * @description Opaque public preparation identifier returned by direct prepare
9242
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9243
- */
9244
- preparationId: string;
9245
- clientContext?: {
9246
- clientIp?: string;
9247
- userAgent?: string;
9248
- sessionId?: string;
9249
- deviceId?: string;
9250
- platform?: string;
9251
- appVersion?: string;
9252
- };
9253
- };
9254
- "multipart/form-data": {
9255
- /**
9256
- * @description Opaque public preparation identifier returned by direct prepare
9257
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9258
- */
9259
- preparationId: string;
9260
- clientContext?: {
9261
- clientIp?: string;
9262
- userAgent?: string;
9263
- sessionId?: string;
9264
- deviceId?: string;
9265
- platform?: string;
9266
- appVersion?: string;
9267
- };
9268
- };
9269
- };
9270
- };
9271
- responses: {
9272
- /** @description An ACH debit deposit authorized by the user and processed asynchronously through debit and crypto release lifecycles. */
9273
- 200: {
9274
- headers: {
9275
- [name: string]: unknown;
9276
- };
9277
- content: {
9278
- "application/json": {
9279
- /**
9280
- * @description Opaque public deposit identifier
9281
- * @example dep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9282
- */
9283
- id: string;
9284
- /**
9285
- * @description Opaque public funding source identifier
9286
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9287
- */
9288
- sourceId: string;
9289
- /**
9290
- * @description Opaque public deposit destination identifier
9291
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
9292
- */
9293
- destinationId: string;
9294
7984
  /** @enum {string} */
9295
7985
  status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
9296
7986
  /** @enum {string} */
@@ -9310,12 +8000,8 @@ interface operations {
9310
8000
  maxAmountUsd: string | null;
9311
8001
  appliedAmountUsd: string;
9312
8002
  } | null;
9313
- /**
9314
- * @description Blockchain network for the bound deposit destination
9315
- * @example solana
9316
- * @constant
9317
- */
9318
- network: "solana";
8003
+ /** @enum {string} */
8004
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
9319
8005
  /**
9320
8006
  * @description Asset sent to the deposit destination
9321
8007
  * @example USDC
@@ -9481,7 +8167,34 @@ interface operations {
9481
8167
  path?: never;
9482
8168
  cookie?: never;
9483
8169
  };
9484
- requestBody?: never;
8170
+ requestBody: {
8171
+ content: {
8172
+ "application/json": {
8173
+ /**
8174
+ * @description Plaid OAuth redirect target. For web, use a URL. For iOS, use a universal link. For Android, use the package name.
8175
+ * @example https://app.example.com/plaid/oauth-return
8176
+ * @example com.example.app
8177
+ */
8178
+ redirectUri?: string;
8179
+ } | Record<string, never>;
8180
+ "application/x-www-form-urlencoded": {
8181
+ /**
8182
+ * @description Plaid OAuth redirect target. For web, use a URL. For iOS, use a universal link. For Android, use the package name.
8183
+ * @example https://app.example.com/plaid/oauth-return
8184
+ * @example com.example.app
8185
+ */
8186
+ redirectUri?: string;
8187
+ } | Record<string, never>;
8188
+ "multipart/form-data": {
8189
+ /**
8190
+ * @description Plaid OAuth redirect target. For web, use a URL. For iOS, use a universal link. For Android, use the package name.
8191
+ * @example https://app.example.com/plaid/oauth-return
8192
+ * @example com.example.app
8193
+ */
8194
+ redirectUri?: string;
8195
+ } | Record<string, never>;
8196
+ };
8197
+ };
9485
8198
  responses: {
9486
8199
  /** @description Response for status 200 */
9487
8200
  200: {
@@ -12885,7 +11598,7 @@ interface operations {
12885
11598
  accessToken: string;
12886
11599
  /**
12887
11600
  * @description The internal ID of the authorized user
12888
- * @example 69fcc3849e56476d70fe62a4
11601
+ * @example 6a05da63c358f286e124ba06
12889
11602
  */
12890
11603
  userId: string;
12891
11604
  /**
@@ -12901,7 +11614,7 @@ interface operations {
12901
11614
  /**
12902
11615
  * Format: date-time
12903
11616
  * @description ISO 8601 timestamp when token expires
12904
- * @example 2026-05-07T17:53:24.550Z
11617
+ * @example 2026-05-14T15:21:23.651Z
12905
11618
  */
12906
11619
  expiresAt: string;
12907
11620
  };
@@ -13076,7 +11789,7 @@ interface operations {
13076
11789
  /**
13077
11790
  * Format: date-time
13078
11791
  * @description ISO 8601 timestamp of when the integrator was created
13079
- * @example 2026-05-07T16:53:24.550Z
11792
+ * @example 2026-05-14T14:21:23.650Z
13080
11793
  */
13081
11794
  createdAt: string;
13082
11795
  };
@@ -13247,7 +11960,7 @@ interface operations {
13247
11960
  depositId: string;
13248
11961
  /**
13249
11962
  * @description Spritz user ID associated with the returned deposit
13250
- * @example 69fcc3849e56476d70fe62a3
11963
+ * @example 6a05da63c358f286e124ba05
13251
11964
  */
13252
11965
  userId: string;
13253
11966
  /**
@@ -13435,7 +12148,7 @@ interface operations {
13435
12148
  depositId: string;
13436
12149
  /**
13437
12150
  * @description Spritz user ID associated with the returned deposit
13438
- * @example 69fcc3849e56476d70fe62a3
12151
+ * @example 6a05da63c358f286e124ba05
13439
12152
  */
13440
12153
  userId: string;
13441
12154
  /**
@@ -13604,7 +12317,7 @@ interface operations {
13604
12317
  "application/json": {
13605
12318
  /**
13606
12319
  * @description Unique identifier for the webhook
13607
- * @example 69fcc3849e56476d70fe62a5
12320
+ * @example 6a05da63c358f286e124ba07
13608
12321
  */
13609
12322
  id: string;
13610
12323
  /** @description List of event types this webhook is subscribed to */
@@ -13811,7 +12524,7 @@ interface operations {
13811
12524
  "application/json": {
13812
12525
  /**
13813
12526
  * @description Unique identifier for the webhook
13814
- * @example 69fcc3849e56476d70fe62a5
12527
+ * @example 6a05da63c358f286e124ba07
13815
12528
  */
13816
12529
  id: string;
13817
12530
  /** @description List of event types this webhook is subscribed to */
@@ -14147,7 +12860,7 @@ interface operations {
14147
12860
  "application/json": {
14148
12861
  /**
14149
12862
  * @description Unique identifier for the webhook
14150
- * @example 69fcc3849e56476d70fe62a5
12863
+ * @example 6a05da63c358f286e124ba07
14151
12864
  */
14152
12865
  id: string;
14153
12866
  /** @description List of event types this webhook is subscribed to */
@@ -14522,7 +13235,7 @@ interface operations {
14522
13235
  /**
14523
13236
  * Format: date-time
14524
13237
  * @description ISO 8601 timestamp when the old secret will expire. Only present if a grace period was specified.
14525
- * @example 2026-05-07T16:58:24.550Z
13238
+ * @example 2026-05-14T14:26:23.651Z
14526
13239
  */
14527
13240
  oldSecretExpiresAt?: string;
14528
13241
  };
@@ -14669,7 +13382,7 @@ interface operations {
14669
13382
  "application/json": {
14670
13383
  /**
14671
13384
  * @description Unique identifier for the user
14672
- * @example 69fcc3849e56476d70fe62a1
13385
+ * @example 6a05da63c358f286e124ba03
14673
13386
  */
14674
13387
  id: string;
14675
13388
  email: (string | null) | null;
@@ -14677,7 +13390,7 @@ interface operations {
14677
13390
  /**
14678
13391
  * Format: date-time
14679
13392
  * @description ISO 8601 timestamp of when the user was created
14680
- * @example 2026-05-07T16:53:24.483Z
13393
+ * @example 2026-05-14T14:21:23.645Z
14681
13394
  */
14682
13395
  signedUpAt: string;
14683
13396
  timezone: (string | null) | null;
@@ -15007,7 +13720,7 @@ interface operations {
15007
13720
  "application/json": {
15008
13721
  /**
15009
13722
  * @description Unique identifier for the user
15010
- * @example 69fcc3849e56476d70fe62a1
13723
+ * @example 6a05da63c358f286e124ba03
15011
13724
  */
15012
13725
  id: string;
15013
13726
  email: (string | null) | null;
@@ -15015,7 +13728,7 @@ interface operations {
15015
13728
  /**
15016
13729
  * Format: date-time
15017
13730
  * @description ISO 8601 timestamp of when the user was created
15018
- * @example 2026-05-07T16:53:24.483Z
13731
+ * @example 2026-05-14T14:21:23.645Z
15019
13732
  */
15020
13733
  signedUpAt: string;
15021
13734
  timezone: (string | null) | null;
@@ -15417,7 +14130,7 @@ interface operations {
15417
14130
  "application/json": {
15418
14131
  /**
15419
14132
  * @description Unique identifier for the user
15420
- * @example 69fcc3849e56476d70fe62a1
14133
+ * @example 6a05da63c358f286e124ba03
15421
14134
  */
15422
14135
  id: string;
15423
14136
  email: (string | null) | null;
@@ -15425,7 +14138,7 @@ interface operations {
15425
14138
  /**
15426
14139
  * Format: date-time
15427
14140
  * @description ISO 8601 timestamp of when the user was created
15428
- * @example 2026-05-07T16:53:24.483Z
14141
+ * @example 2026-05-14T14:21:23.645Z
15429
14142
  */
15430
14143
  signedUpAt: string;
15431
14144
  timezone: (string | null) | null;
@@ -21972,181 +20685,7 @@ interface operations {
21972
20685
  * @example /errors/1234567890
21973
20686
  */
21974
20687
  instance?: string;
21975
- };
21976
- };
21977
- };
21978
- /** @description Response for status 401 */
21979
- 401: {
21980
- headers: {
21981
- [name: string]: unknown;
21982
- };
21983
- content: {
21984
- "application/json": {
21985
- /**
21986
- * @description A URI reference that identifies the problem type
21987
- * @default about:blank
21988
- * @example urn:problem-type:auth:unauthorized
21989
- * @example urn:problem-type:auth:token-expired
21990
- */
21991
- type: string;
21992
- /**
21993
- * @description A short, human-readable summary of the problem type
21994
- * @example Unauthorized
21995
- * @example Token Expired
21996
- */
21997
- title: string;
21998
- /**
21999
- * @description The HTTP status code
22000
- * @example 401
22001
- * @example 403
22002
- */
22003
- status: number;
22004
- /**
22005
- * @description A human-readable explanation specific to this occurrence
22006
- * @example Bearer token required
22007
- * @example Invalid token
22008
- */
22009
- detail?: string;
22010
- /** @description A URI reference that identifies the specific occurrence */
22011
- instance?: string;
22012
- /**
22013
- * @description The authentication realm
22014
- * @example API
22015
- */
22016
- realm?: string;
22017
- /**
22018
- * @description The required scope for this resource
22019
- * @example read:users
22020
- * @example write:orders
22021
- */
22022
- scope?: string;
22023
- };
22024
- };
22025
- };
22026
- /** @description Response for status 500 */
22027
- 500: {
22028
- headers: {
22029
- [name: string]: unknown;
22030
- };
22031
- content: {
22032
- "application/json": {
22033
- /**
22034
- * @description A URI reference that identifies the problem type
22035
- * @default about:blank
22036
- * @example urn:problem-type:auth:unauthorized
22037
- * @example urn:problem-type:system:internal-error
22038
- */
22039
- type: string;
22040
- /**
22041
- * @description A short, human-readable summary of the problem type
22042
- * @example Unauthorized
22043
- * @example Internal Server Error
22044
- */
22045
- title: string;
22046
- /**
22047
- * @description The HTTP status code
22048
- * @example 400
22049
- * @example 401
22050
- * @example 404
22051
- * @example 500
22052
- */
22053
- status: number;
22054
- /** @description A human-readable explanation specific to this occurrence */
22055
- detail?: string;
22056
- /**
22057
- * @description A URI reference that identifies the specific occurrence
22058
- * @example /errors/1234567890
22059
- */
22060
- instance?: string;
22061
- };
22062
- };
22063
- };
22064
- /** @description Response for status 502 */
22065
- 502: {
22066
- headers: {
22067
- [name: string]: unknown;
22068
- };
22069
- content: {
22070
- "application/json": {
22071
- /**
22072
- * @description A URI reference that identifies the problem type
22073
- * @default about:blank
22074
- * @example urn:problem-type:auth:unauthorized
22075
- * @example urn:problem-type:system:internal-error
22076
- */
22077
- type: string;
22078
- /**
22079
- * @description A short, human-readable summary of the problem type
22080
- * @example Unauthorized
22081
- * @example Internal Server Error
22082
- */
22083
- title: string;
22084
- /**
22085
- * @description The HTTP status code
22086
- * @example 400
22087
- * @example 401
22088
- * @example 404
22089
- * @example 500
22090
- */
22091
- status: number;
22092
- /** @description A human-readable explanation specific to this occurrence */
22093
- detail?: string;
22094
- /**
22095
- * @description A URI reference that identifies the specific occurrence
22096
- * @example /errors/1234567890
22097
- */
22098
- instance?: string;
22099
- };
22100
- };
22101
- };
22102
- };
22103
- };
22104
- "postV1SandboxBypass-kyc": {
22105
- parameters: {
22106
- query?: never;
22107
- header?: never;
22108
- path?: never;
22109
- cookie?: never;
22110
- };
22111
- requestBody: {
22112
- content: {
22113
- "application/json": {
22114
- /**
22115
- * @description Country code to simulate successful KYC for
22116
- * @example US
22117
- */
22118
- country?: string;
22119
- /** @description Set to true to simulate a failed KYC check */
22120
- failed?: boolean;
22121
- };
22122
- "application/x-www-form-urlencoded": {
22123
- /**
22124
- * @description Country code to simulate successful KYC for
22125
- * @example US
22126
- */
22127
- country?: string;
22128
- /** @description Set to true to simulate a failed KYC check */
22129
- failed?: boolean;
22130
- };
22131
- "multipart/form-data": {
22132
- /**
22133
- * @description Country code to simulate successful KYC for
22134
- * @example US
22135
- */
22136
- country?: string;
22137
- /** @description Set to true to simulate a failed KYC check */
22138
- failed?: boolean;
22139
- };
22140
- };
22141
- };
22142
- responses: {
22143
- /** @description The resulting verification document */
22144
- 200: {
22145
- headers: {
22146
- [name: string]: unknown;
22147
- };
22148
- content: {
22149
- "application/json": unknown;
20688
+ };
22150
20689
  };
22151
20690
  };
22152
20691
  /** @description Response for status 401 */
@@ -22235,9 +20774,47 @@ interface operations {
22235
20774
  };
22236
20775
  };
22237
20776
  };
20777
+ /** @description Response for status 502 */
20778
+ 502: {
20779
+ headers: {
20780
+ [name: string]: unknown;
20781
+ };
20782
+ content: {
20783
+ "application/json": {
20784
+ /**
20785
+ * @description A URI reference that identifies the problem type
20786
+ * @default about:blank
20787
+ * @example urn:problem-type:auth:unauthorized
20788
+ * @example urn:problem-type:system:internal-error
20789
+ */
20790
+ type: string;
20791
+ /**
20792
+ * @description A short, human-readable summary of the problem type
20793
+ * @example Unauthorized
20794
+ * @example Internal Server Error
20795
+ */
20796
+ title: string;
20797
+ /**
20798
+ * @description The HTTP status code
20799
+ * @example 400
20800
+ * @example 401
20801
+ * @example 404
20802
+ * @example 500
20803
+ */
20804
+ status: number;
20805
+ /** @description A human-readable explanation specific to this occurrence */
20806
+ detail?: string;
20807
+ /**
20808
+ * @description A URI reference that identifies the specific occurrence
20809
+ * @example /errors/1234567890
20810
+ */
20811
+ instance?: string;
20812
+ };
20813
+ };
20814
+ };
22238
20815
  };
22239
20816
  };
22240
- postV1SandboxDeposits: {
20817
+ "postV1SandboxBypass-kyc": {
22241
20818
  parameters: {
22242
20819
  query?: never;
22243
20820
  header?: never;
@@ -22248,159 +20825,41 @@ interface operations {
22248
20825
  content: {
22249
20826
  "application/json": {
22250
20827
  /**
22251
- * @description Opaque public preparation identifier returned by prepare
22252
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
20828
+ * @description Country code to simulate successful KYC for
20829
+ * @example US
22253
20830
  */
22254
- preparationId: string;
22255
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
22256
- signature: string;
22257
- clientContext?: {
22258
- clientIp?: string;
22259
- userAgent?: string;
22260
- sessionId?: string;
22261
- deviceId?: string;
22262
- platform?: string;
22263
- appVersion?: string;
22264
- };
22265
- returnSimulation: {
22266
- /**
22267
- * @description Sandbox-only ACH return code to simulate through the Modern Treasury provider path
22268
- * @example R10
22269
- */
22270
- code: string;
22271
- };
20831
+ country?: string;
20832
+ /** @description Set to true to simulate a failed KYC check */
20833
+ failed?: boolean;
22272
20834
  };
22273
20835
  "application/x-www-form-urlencoded": {
22274
20836
  /**
22275
- * @description Opaque public preparation identifier returned by prepare
22276
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
20837
+ * @description Country code to simulate successful KYC for
20838
+ * @example US
22277
20839
  */
22278
- preparationId: string;
22279
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
22280
- signature: string;
22281
- clientContext?: {
22282
- clientIp?: string;
22283
- userAgent?: string;
22284
- sessionId?: string;
22285
- deviceId?: string;
22286
- platform?: string;
22287
- appVersion?: string;
22288
- };
22289
- returnSimulation: {
22290
- /**
22291
- * @description Sandbox-only ACH return code to simulate through the Modern Treasury provider path
22292
- * @example R10
22293
- */
22294
- code: string;
22295
- };
20840
+ country?: string;
20841
+ /** @description Set to true to simulate a failed KYC check */
20842
+ failed?: boolean;
22296
20843
  };
22297
20844
  "multipart/form-data": {
22298
20845
  /**
22299
- * @description Opaque public preparation identifier returned by prepare
22300
- * @example prep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
20846
+ * @description Country code to simulate successful KYC for
20847
+ * @example US
22301
20848
  */
22302
- preparationId: string;
22303
- /** @description Ed25519 signature over the exact authorization message text. Base58 is preferred for Solana clients; base64 is also accepted. */
22304
- signature: string;
22305
- clientContext?: {
22306
- clientIp?: string;
22307
- userAgent?: string;
22308
- sessionId?: string;
22309
- deviceId?: string;
22310
- platform?: string;
22311
- appVersion?: string;
22312
- };
22313
- returnSimulation: {
22314
- /**
22315
- * @description Sandbox-only ACH return code to simulate through the Modern Treasury provider path
22316
- * @example R10
22317
- */
22318
- code: string;
22319
- };
20849
+ country?: string;
20850
+ /** @description Set to true to simulate a failed KYC check */
20851
+ failed?: boolean;
22320
20852
  };
22321
20853
  };
22322
20854
  };
22323
20855
  responses: {
22324
- /** @description An ACH debit deposit authorized by the user and processed asynchronously through debit and crypto release lifecycles. */
20856
+ /** @description The resulting verification document */
22325
20857
  200: {
22326
20858
  headers: {
22327
20859
  [name: string]: unknown;
22328
20860
  };
22329
20861
  content: {
22330
- "application/json": {
22331
- /**
22332
- * @description Opaque public deposit identifier
22333
- * @example dep_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
22334
- */
22335
- id: string;
22336
- /**
22337
- * @description Opaque public funding source identifier
22338
- * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
22339
- */
22340
- sourceId: string;
22341
- /**
22342
- * @description Opaque public deposit destination identifier
22343
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
22344
- */
22345
- destinationId: string;
22346
- /** @enum {string} */
22347
- status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
22348
- /** @enum {string} */
22349
- quoteType: "exact_input" | "exact_output";
22350
- /** @enum {string} */
22351
- priority: "normal" | "high";
22352
- feeRateBps: number;
22353
- principalAmountUsd: string;
22354
- expectedAssetAmount: string;
22355
- grossFeeUsd: string;
22356
- feeSubsidyUsd: string;
22357
- userFeeUsd: string;
22358
- totalDebitAmountUsd: string;
22359
- feeSubsidy: {
22360
- percentage: number;
22361
- percentageBps: number;
22362
- maxAmountUsd: string | null;
22363
- appliedAmountUsd: string;
22364
- } | null;
22365
- /**
22366
- * @description Blockchain network for the bound deposit destination
22367
- * @example solana
22368
- * @constant
22369
- */
22370
- network: "solana";
22371
- /**
22372
- * @description Asset sent to the deposit destination
22373
- * @example USDC
22374
- * @constant
22375
- */
22376
- asset: "USDC";
22377
- assetAddress: string;
22378
- /** @description Destination wallet address for the crypto release */
22379
- address: string;
22380
- /** @enum {string} */
22381
- debitStatus: "authorized" | "submitting" | "submitted" | "settled" | "returned" | "failed";
22382
- /** @enum {string} */
22383
- releaseStatus: "not_started" | "queued" | "partial" | "completed" | "failed";
22384
- /** @enum {string} */
22385
- releaseDecisionMode: "after_settlement" | "early_full" | "early_partial";
22386
- releasedAmountUsd: string;
22387
- confirmedReleasedAmountUsd: string;
22388
- exposureAmountUsd: string;
22389
- /** Format: date-time */
22390
- authorizedAt: string;
22391
- /** Format: date-time */
22392
- createdAt: string;
22393
- settledAt: string | null;
22394
- returnedAt: string | null;
22395
- completedAt: string | null;
22396
- returnCode: string | null;
22397
- returnReason: string | null;
22398
- debitFailureCode: string | null;
22399
- debitFailureReason: string | null;
22400
- releaseFailureCode: string | null;
22401
- releaseFailureReason: string | null;
22402
- payoutTxHash: string | null;
22403
- };
20862
+ "application/json": unknown;
22404
20863
  };
22405
20864
  };
22406
20865
  /** @description Response for status 401 */
@@ -22451,79 +20910,6 @@ interface operations {
22451
20910
  };
22452
20911
  };
22453
20912
  };
22454
- /** @description Response for status 403 */
22455
- 403: {
22456
- headers: {
22457
- [name: string]: unknown;
22458
- };
22459
- content: {
22460
- "application/json": {
22461
- /**
22462
- * @description A URI reference that identifies the problem type
22463
- * @default about:blank
22464
- * @example urn:problem-type:auth:unauthorized
22465
- * @example urn:problem-type:system:internal-error
22466
- */
22467
- type: string;
22468
- /**
22469
- * @description A short, human-readable summary of the problem type
22470
- * @example Unauthorized
22471
- * @example Internal Server Error
22472
- */
22473
- title: string;
22474
- /**
22475
- * @description The HTTP status code
22476
- * @example 400
22477
- * @example 401
22478
- * @example 404
22479
- * @example 500
22480
- */
22481
- status: number;
22482
- /** @description A human-readable explanation specific to this occurrence */
22483
- detail?: string;
22484
- /**
22485
- * @description A URI reference that identifies the specific occurrence
22486
- * @example /errors/1234567890
22487
- */
22488
- instance?: string;
22489
- };
22490
- };
22491
- };
22492
- /** @description Response for status 404 */
22493
- 404: {
22494
- headers: {
22495
- [name: string]: unknown;
22496
- };
22497
- content: {
22498
- "application/json": {
22499
- /**
22500
- * @description A URI reference that identifies the problem type
22501
- * @default about:blank
22502
- */
22503
- type: string;
22504
- /** @description A short, human-readable summary of the problem type */
22505
- title: string;
22506
- /**
22507
- * @description The HTTP status code
22508
- * @example 404
22509
- */
22510
- status: number;
22511
- /** @description A human-readable explanation specific to this occurrence */
22512
- detail?: string;
22513
- /** @description A URI reference that identifies the specific occurrence */
22514
- instance?: string;
22515
- /**
22516
- * @description The type of resource that was not found
22517
- * @example user
22518
- * @example account
22519
- * @example transaction
22520
- */
22521
- resourceType: string;
22522
- /** @description The identifier of the resource that was not found */
22523
- resourceId: string;
22524
- };
22525
- };
22526
- };
22527
20913
  /** @description Response for status 500 */
22528
20914
  500: {
22529
20915
  headers: {
@@ -22659,11 +21045,6 @@ interface operations {
22659
21045
  * @example fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
22660
21046
  */
22661
21047
  sourceId: string;
22662
- /**
22663
- * @description Opaque public deposit destination identifier
22664
- * @example dd_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
22665
- */
22666
- destinationId: string;
22667
21048
  /** @enum {string} */
22668
21049
  status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
22669
21050
  /** @enum {string} */
@@ -22683,12 +21064,8 @@ interface operations {
22683
21064
  maxAmountUsd: string | null;
22684
21065
  appliedAmountUsd: string;
22685
21066
  } | null;
22686
- /**
22687
- * @description Blockchain network for the bound deposit destination
22688
- * @example solana
22689
- * @constant
22690
- */
22691
- network: "solana";
21067
+ /** @enum {string} */
21068
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
22692
21069
  /**
22693
21070
  * @description Asset sent to the deposit destination
22694
21071
  * @example USDC
@@ -23579,6 +21956,7 @@ type CreateBankAccountInput = PathRequestBody<'/v1/bank-accounts/', 'post'>;
23579
21956
  type CreateBankAccountResponse = PathResponse<'/v1/bank-accounts/', 'post'>;
23580
21957
  type DeleteBankAccountResponse = PathResponse<'/v1/bank-accounts/{accountId}', 'delete'>;
23581
21958
  type LinkTokenResponse = PathResponse<'/v1/bank-accounts/link-token', 'post'>;
21959
+ type CreateLinkTokenRequest = PathRequestBody<'/v1/bank-accounts/link-token', 'post'>;
23582
21960
  type CompleteLinkingRequest = PathRequestBody<'/v1/bank-accounts/link-complete', 'post'>;
23583
21961
  type CompleteLinkingResponse = PathResponse<'/v1/bank-accounts/link-complete', 'post'>;
23584
21962
  declare class BankAccountService {
@@ -23792,7 +22170,7 @@ declare class BankAccountService {
23792
22170
  id: string;
23793
22171
  deleted: true;
23794
22172
  }>;
23795
- createLinkToken(): Promise<{
22173
+ createLinkToken(input?: CreateLinkTokenRequest): Promise<{
23796
22174
  linkToken: string;
23797
22175
  hostedLinkUrl: string | null;
23798
22176
  expiration: string;
@@ -25378,7 +23756,7 @@ declare class DepositService {
25378
23756
  maxAmountUsd: string | null;
25379
23757
  appliedAmountUsd: string;
25380
23758
  } | null;
25381
- network: "solana";
23759
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
25382
23760
  asset: "USDC";
25383
23761
  assetAddress: string;
25384
23762
  destinationAddress: string;
@@ -25387,7 +23765,6 @@ declare class DepositService {
25387
23765
  create(input: CreateDepositRequest): Promise<{
25388
23766
  id: string;
25389
23767
  sourceId: string;
25390
- destinationId: string;
25391
23768
  status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
25392
23769
  quoteType: "exact_input" | "exact_output";
25393
23770
  priority: "normal" | "high";
@@ -25404,7 +23781,7 @@ declare class DepositService {
25404
23781
  maxAmountUsd: string | null;
25405
23782
  appliedAmountUsd: string;
25406
23783
  } | null;
25407
- network: "solana";
23784
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
25408
23785
  asset: "USDC";
25409
23786
  assetAddress: string;
25410
23787
  address: string;
@@ -25496,7 +23873,6 @@ declare class SandboxService {
25496
23873
  createDepositWithReturn(input: CreateDepositWithReturnRequest): Promise<{
25497
23874
  id: string;
25498
23875
  sourceId: string;
25499
- destinationId: string;
25500
23876
  status: "authorized" | "processing" | "partially_released" | "completed" | "returned" | "failed";
25501
23877
  quoteType: "exact_input" | "exact_output";
25502
23878
  priority: "normal" | "high";
@@ -25513,7 +23889,7 @@ declare class SandboxService {
25513
23889
  maxAmountUsd: string | null;
25514
23890
  appliedAmountUsd: string;
25515
23891
  } | null;
25516
- network: "solana";
23892
+ network: "solana" | "ethereum" | "polygon" | "base" | "avalanche" | "arbitrum";
25517
23893
  asset: "USDC";
25518
23894
  assetAddress: string;
25519
23895
  address: string;