@optimex-xyz/market-maker-sdk 0.6.0 → 0.6.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.
package/README.md CHANGED
@@ -12,6 +12,9 @@ A comprehensive guide for implementing Private Market Makers (PMMs) in the cross
12
12
  - [1.1. Integration Flow](#11-integration-flow)
13
13
  - [2. Quick Start](#2-quick-start)
14
14
  - [2.1. API Environments](#21-api-environments)
15
+ - [Development Environment](#development-environment)
16
+ - [Pre-production Environment](#pre-production-environment)
17
+ - [Production Environment](#production-environment)
15
18
  - [3. PMM Backend APIs](#3-pmm-backend-apis)
16
19
  - [3.1. Endpoint: `/indicative-quote`](#31-endpoint-indicative-quote)
17
20
  - [Description](#description)
@@ -104,23 +107,44 @@ sequenceDiagram
104
107
 
105
108
  ### 2.1. API Environments
106
109
 
107
- | Environment | Description |
108
- | ---------------- | -------------------------------------------------------------------- |
109
- | `dev` | Development environment with test networks and staging services |
110
- | `pre-production` | Pre-production environment with mainnet networks for testing before release |
110
+ | Environment | Description |
111
+ | ---------------- | -------------------------------------------------------------------- |
112
+ | `dev` | Development environment with test networks and staging services |
113
+ | `prelive` | Pre-production environment with mainnet networks for testing before release |
111
114
  | `production` | Production environment with mainnet networks and production services |
112
115
 
113
- - Solver URLs: Each environment has dedicated API endpoints
114
-
115
- - RPC Endpoints: L2 RPC endpoints
116
-
117
- - Router Addresses: Smart contract addresses for routing transactions
118
-
119
- - **Note:** pre-production and production share the same router addresses
120
-
121
- - Payment Addresses: Addresses used for fee collection and settlement
122
-
123
- - **Note:** pre-production and production share the same payment addresses
116
+ #### Development Environment
117
+ Development environment with test networks and staging services
118
+
119
+ - **Signer**: 0xA89F5060B810F3b6027D7663880c43ee77A865C7
120
+ - **Router**: 0x193501E5F72a42DACCF8Eb1C4AB37561c213309D
121
+ - **Payment**: 0x7387DcCfE2f1D5F80b4ECDF91eF58541517e90D2
122
+ - **ETHVault**: 0x17aD543010fc8E8065b85E203839C0CBEcdfC851
123
+ - **WETHVault**: 0x673Ac1489457F43F04403940cE425ae19a9D639B
124
+ - **USDTVault**: 0x62179B12Ce75B81Fcb4a2B634aD92DDaeF728e9C
125
+ - **WBTCVault**: 0x04D0C9a5bb122958D8A64049068FD8570dDfA3Dc
126
+
127
+ #### Pre-production Environment
128
+ Pre-production environment with mainnet networks for testing before release
129
+
130
+ - **Signer**: [0xCF9786F123F1071023dB8049808C223e94c384be](https://scan.optimex.xyz/address/0xCF9786F123F1071023dB8049808C223e94c384be)
131
+ - **Router**: [0xcceAb862dD41f6691d81Cc016216Cd45d7BD6D4A](https://scan.optimex.xyz/address/0xcceAb862dD41f6691d81Cc016216Cd45d7BD6D4A)
132
+ - **Payment**: [0x0A497AC4261E37FA4062762C23Cf3cB642C839b8](https://etherscan.io/address/0x0A497AC4261E37FA4062762C23Cf3cB642C839b8)
133
+ - **ETHVault**: [0xF7fedF4A250157010807E6eA60258E3B768149Ff](https://etherscan.io/address/0xF7fedF4A250157010807E6eA60258E3B768149Ff)
134
+ - **WETHVault**: [0xaD3f379AaED8Eca895209Af446F2e34f07145dbC](https://etherscan.io/address/0xaD3f379AaED8Eca895209Af446F2e34f07145dbC)
135
+ - **USDTVault**: [0x0712CAB9e52a37aFC6fA768b20cc9b07325314fB](https://etherscan.io/address/0x0712CAB9e52a37aFC6fA768b20cc9b07325314fB)
136
+ - **WBTCVault**: [0xCd6B5F600559104Ee19320B9F9C3b2c7672cb895](https://etherscan.io/address/0xCd6B5F600559104Ee19320B9F9C3b2c7672cb895)
137
+
138
+ #### Production Environment
139
+ Production environment with mainnet networks and production services
140
+
141
+ - **Signer**: [0xCF9786F123F1071023dB8049808C223e94c384be](https://scan.optimex.xyz/address/0xCF9786F123F1071023dB8049808C223e94c384be)
142
+ - **Router**: [0xcceAb862dD41f6691d81Cc016216Cd45d7BD6D4A](https://scan.optimex.xyz/address/0xcceAb862dD41f6691d81Cc016216Cd45d7BD6D4A)
143
+ - **Payment**: [0x0A497AC4261E37FA4062762C23Cf3cB642C839b8](https://etherscan.io/address/0x0A497AC4261E37FA4062762C23Cf3cB642C839b8)
144
+ - **ETHVault**: [0xF7fedF4A250157010807E6eA60258E3B768149Ff](https://etherscan.io/address/0xF7fedF4A250157010807E6eA60258E3B768149Ff)
145
+ - **WETHVault**: [0xaD3f379AaED8Eca895209Af446F2e34f07145dbC](https://etherscan.io/address/0xaD3f379AaED8Eca895209Af446F2e34f07145dbC)
146
+ - **USDTVault**: [0x0712CAB9e52a37aFC6fA768b20cc9b07325314fB](https://etherscan.io/address/0x0712CAB9e52a37aFC6fA768b20cc9b07325314fB)
147
+ - **WBTCVault**: [0xCd6B5F600559104Ee19320B9F9C3b2c7672cb895](https://etherscan.io/address/0xCd6B5F600559104Ee19320B9F9C3b2c7672cb895)
124
148
 
125
149
  ## 3. PMM Backend APIs
126
150
 
package/dist/index.d.mts CHANGED
@@ -5203,14 +5203,14 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5203
5203
  bestIndicativeQuote: z.ZodString;
5204
5204
  displayIndicativeQuote: z.ZodString;
5205
5205
  pmmFinalists: z.ZodArray<z.ZodObject<{
5206
- pmmId: z.ZodString;
5207
- pmmReceivingAddress: z.ZodString;
5206
+ pmmId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5207
+ pmmReceivingAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5208
5208
  }, "strip", z.ZodTypeAny, {
5209
5209
  pmmId: string;
5210
5210
  pmmReceivingAddress: string;
5211
5211
  }, {
5212
- pmmId: string;
5213
- pmmReceivingAddress: string;
5212
+ pmmId?: string | undefined;
5213
+ pmmReceivingAddress?: string | undefined;
5214
5214
  }>, "many">;
5215
5215
  settlementQuote: z.ZodString;
5216
5216
  receivingAmount: z.ZodString;
@@ -5225,26 +5225,26 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5225
5225
  userDepositTx: z.ZodString;
5226
5226
  depositVault: z.ZodString;
5227
5227
  paymentBundle: z.ZodObject<{
5228
- tradeIds: z.ZodArray<z.ZodString, "many">;
5229
- settlementTx: z.ZodString;
5230
- signature: z.ZodString;
5231
- startIndex: z.ZodNumber;
5232
- pmmId: z.ZodString;
5233
- signedAt: z.ZodNumber;
5228
+ tradeIds: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
5229
+ settlementTx: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5230
+ signature: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5231
+ startIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5232
+ pmmId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5233
+ signedAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5234
5234
  }, "strip", z.ZodTypeAny, {
5235
5235
  signature: string;
5236
- tradeIds: string[];
5236
+ tradeIds: string[] | null;
5237
5237
  signedAt: number;
5238
5238
  pmmId: string;
5239
5239
  settlementTx: string;
5240
5240
  startIndex: number;
5241
5241
  }, {
5242
- signature: string;
5243
- tradeIds: string[];
5244
- signedAt: number;
5245
- pmmId: string;
5246
- settlementTx: string;
5247
- startIndex: number;
5242
+ tradeIds: string[] | null;
5243
+ signature?: string | undefined;
5244
+ signedAt?: number | undefined;
5245
+ pmmId?: string | undefined;
5246
+ settlementTx?: string | undefined;
5247
+ startIndex?: number | undefined;
5248
5248
  }>;
5249
5249
  userSignature: z.ZodString;
5250
5250
  tradeSubmissionTx: z.ZodString;
@@ -5306,7 +5306,7 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5306
5306
  depositVault: string;
5307
5307
  paymentBundle: {
5308
5308
  signature: string;
5309
- tradeIds: string[];
5309
+ tradeIds: string[] | null;
5310
5310
  signedAt: number;
5311
5311
  pmmId: string;
5312
5312
  settlementTx: string;
@@ -5353,8 +5353,8 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5353
5353
  bestIndicativeQuote: string;
5354
5354
  displayIndicativeQuote: string;
5355
5355
  pmmFinalists: {
5356
- pmmId: string;
5357
- pmmReceivingAddress: string;
5356
+ pmmId?: string | undefined;
5357
+ pmmReceivingAddress?: string | undefined;
5358
5358
  }[];
5359
5359
  settlementQuote: string;
5360
5360
  receivingAmount: string;
@@ -5368,12 +5368,12 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5368
5368
  userDepositTx: string;
5369
5369
  depositVault: string;
5370
5370
  paymentBundle: {
5371
- signature: string;
5372
- tradeIds: string[];
5373
- signedAt: number;
5374
- pmmId: string;
5375
- settlementTx: string;
5376
- startIndex: number;
5371
+ tradeIds: string[] | null;
5372
+ signature?: string | undefined;
5373
+ signedAt?: number | undefined;
5374
+ pmmId?: string | undefined;
5375
+ settlementTx?: string | undefined;
5376
+ startIndex?: number | undefined;
5377
5377
  };
5378
5378
  userSignature: string;
5379
5379
  tradeSubmissionTx: string;
@@ -5435,7 +5435,7 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5435
5435
  depositVault: string;
5436
5436
  paymentBundle: {
5437
5437
  signature: string;
5438
- tradeIds: string[];
5438
+ tradeIds: string[] | null;
5439
5439
  signedAt: number;
5440
5440
  pmmId: string;
5441
5441
  settlementTx: string;
@@ -5485,8 +5485,8 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5485
5485
  bestIndicativeQuote: string;
5486
5486
  displayIndicativeQuote: string;
5487
5487
  pmmFinalists: {
5488
- pmmId: string;
5489
- pmmReceivingAddress: string;
5488
+ pmmId?: string | undefined;
5489
+ pmmReceivingAddress?: string | undefined;
5490
5490
  }[];
5491
5491
  settlementQuote: string;
5492
5492
  receivingAmount: string;
@@ -5500,12 +5500,12 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5500
5500
  userDepositTx: string;
5501
5501
  depositVault: string;
5502
5502
  paymentBundle: {
5503
- signature: string;
5504
- tradeIds: string[];
5505
- signedAt: number;
5506
- pmmId: string;
5507
- settlementTx: string;
5508
- startIndex: number;
5503
+ tradeIds: string[] | null;
5504
+ signature?: string | undefined;
5505
+ signedAt?: number | undefined;
5506
+ pmmId?: string | undefined;
5507
+ settlementTx?: string | undefined;
5508
+ startIndex?: number | undefined;
5509
5509
  };
5510
5510
  userSignature: string;
5511
5511
  tradeSubmissionTx: string;
package/dist/index.d.ts CHANGED
@@ -5203,14 +5203,14 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5203
5203
  bestIndicativeQuote: z.ZodString;
5204
5204
  displayIndicativeQuote: z.ZodString;
5205
5205
  pmmFinalists: z.ZodArray<z.ZodObject<{
5206
- pmmId: z.ZodString;
5207
- pmmReceivingAddress: z.ZodString;
5206
+ pmmId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5207
+ pmmReceivingAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5208
5208
  }, "strip", z.ZodTypeAny, {
5209
5209
  pmmId: string;
5210
5210
  pmmReceivingAddress: string;
5211
5211
  }, {
5212
- pmmId: string;
5213
- pmmReceivingAddress: string;
5212
+ pmmId?: string | undefined;
5213
+ pmmReceivingAddress?: string | undefined;
5214
5214
  }>, "many">;
5215
5215
  settlementQuote: z.ZodString;
5216
5216
  receivingAmount: z.ZodString;
@@ -5225,26 +5225,26 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5225
5225
  userDepositTx: z.ZodString;
5226
5226
  depositVault: z.ZodString;
5227
5227
  paymentBundle: z.ZodObject<{
5228
- tradeIds: z.ZodArray<z.ZodString, "many">;
5229
- settlementTx: z.ZodString;
5230
- signature: z.ZodString;
5231
- startIndex: z.ZodNumber;
5232
- pmmId: z.ZodString;
5233
- signedAt: z.ZodNumber;
5228
+ tradeIds: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
5229
+ settlementTx: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5230
+ signature: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5231
+ startIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5232
+ pmmId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
5233
+ signedAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5234
5234
  }, "strip", z.ZodTypeAny, {
5235
5235
  signature: string;
5236
- tradeIds: string[];
5236
+ tradeIds: string[] | null;
5237
5237
  signedAt: number;
5238
5238
  pmmId: string;
5239
5239
  settlementTx: string;
5240
5240
  startIndex: number;
5241
5241
  }, {
5242
- signature: string;
5243
- tradeIds: string[];
5244
- signedAt: number;
5245
- pmmId: string;
5246
- settlementTx: string;
5247
- startIndex: number;
5242
+ tradeIds: string[] | null;
5243
+ signature?: string | undefined;
5244
+ signedAt?: number | undefined;
5245
+ pmmId?: string | undefined;
5246
+ settlementTx?: string | undefined;
5247
+ startIndex?: number | undefined;
5248
5248
  }>;
5249
5249
  userSignature: z.ZodString;
5250
5250
  tradeSubmissionTx: z.ZodString;
@@ -5306,7 +5306,7 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5306
5306
  depositVault: string;
5307
5307
  paymentBundle: {
5308
5308
  signature: string;
5309
- tradeIds: string[];
5309
+ tradeIds: string[] | null;
5310
5310
  signedAt: number;
5311
5311
  pmmId: string;
5312
5312
  settlementTx: string;
@@ -5353,8 +5353,8 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5353
5353
  bestIndicativeQuote: string;
5354
5354
  displayIndicativeQuote: string;
5355
5355
  pmmFinalists: {
5356
- pmmId: string;
5357
- pmmReceivingAddress: string;
5356
+ pmmId?: string | undefined;
5357
+ pmmReceivingAddress?: string | undefined;
5358
5358
  }[];
5359
5359
  settlementQuote: string;
5360
5360
  receivingAmount: string;
@@ -5368,12 +5368,12 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5368
5368
  userDepositTx: string;
5369
5369
  depositVault: string;
5370
5370
  paymentBundle: {
5371
- signature: string;
5372
- tradeIds: string[];
5373
- signedAt: number;
5374
- pmmId: string;
5375
- settlementTx: string;
5376
- startIndex: number;
5371
+ tradeIds: string[] | null;
5372
+ signature?: string | undefined;
5373
+ signedAt?: number | undefined;
5374
+ pmmId?: string | undefined;
5375
+ settlementTx?: string | undefined;
5376
+ startIndex?: number | undefined;
5377
5377
  };
5378
5378
  userSignature: string;
5379
5379
  tradeSubmissionTx: string;
@@ -5435,7 +5435,7 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5435
5435
  depositVault: string;
5436
5436
  paymentBundle: {
5437
5437
  signature: string;
5438
- tradeIds: string[];
5438
+ tradeIds: string[] | null;
5439
5439
  signedAt: number;
5440
5440
  pmmId: string;
5441
5441
  settlementTx: string;
@@ -5485,8 +5485,8 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5485
5485
  bestIndicativeQuote: string;
5486
5486
  displayIndicativeQuote: string;
5487
5487
  pmmFinalists: {
5488
- pmmId: string;
5489
- pmmReceivingAddress: string;
5488
+ pmmId?: string | undefined;
5489
+ pmmReceivingAddress?: string | undefined;
5490
5490
  }[];
5491
5491
  settlementQuote: string;
5492
5492
  receivingAmount: string;
@@ -5500,12 +5500,12 @@ declare const TradeDetailResponseSchema: z.ZodObject<{
5500
5500
  userDepositTx: string;
5501
5501
  depositVault: string;
5502
5502
  paymentBundle: {
5503
- signature: string;
5504
- tradeIds: string[];
5505
- signedAt: number;
5506
- pmmId: string;
5507
- settlementTx: string;
5508
- startIndex: number;
5503
+ tradeIds: string[] | null;
5504
+ signature?: string | undefined;
5505
+ signedAt?: number | undefined;
5506
+ pmmId?: string | undefined;
5507
+ settlementTx?: string | undefined;
5508
+ startIndex?: number | undefined;
5509
5509
  };
5510
5510
  userSignature: string;
5511
5511
  tradeSubmissionTx: string;
package/dist/index.js CHANGED
@@ -4034,16 +4034,16 @@ var TokenInfoSchema = import_zod.z.object({
4034
4034
  feeOut: import_zod.z.boolean()
4035
4035
  });
4036
4036
  var PMMFinalistSchema = import_zod.z.object({
4037
- pmmId: import_zod.z.string(),
4038
- pmmReceivingAddress: import_zod.z.string()
4037
+ pmmId: import_zod.z.string().optional().default(""),
4038
+ pmmReceivingAddress: import_zod.z.string().optional().default("")
4039
4039
  });
4040
4040
  var PaymentBundleSchema = import_zod.z.object({
4041
- tradeIds: import_zod.z.array(import_zod.z.string()),
4042
- settlementTx: import_zod.z.string(),
4043
- signature: import_zod.z.string(),
4044
- startIndex: import_zod.z.number(),
4045
- pmmId: import_zod.z.string(),
4046
- signedAt: import_zod.z.number()
4041
+ tradeIds: import_zod.z.array(import_zod.z.string()).nullable(),
4042
+ settlementTx: import_zod.z.string().optional().default(""),
4043
+ signature: import_zod.z.string().optional().default("0x"),
4044
+ startIndex: import_zod.z.number().optional().default(0),
4045
+ pmmId: import_zod.z.string().optional().default(""),
4046
+ signedAt: import_zod.z.number().optional().default(0)
4047
4047
  });
4048
4048
  var TradeDetailResponseSchema = import_zod.z.object({
4049
4049
  data: import_zod.z.object({
package/dist/index.mjs CHANGED
@@ -3969,16 +3969,16 @@ var TokenInfoSchema = z.object({
3969
3969
  feeOut: z.boolean()
3970
3970
  });
3971
3971
  var PMMFinalistSchema = z.object({
3972
- pmmId: z.string(),
3973
- pmmReceivingAddress: z.string()
3972
+ pmmId: z.string().optional().default(""),
3973
+ pmmReceivingAddress: z.string().optional().default("")
3974
3974
  });
3975
3975
  var PaymentBundleSchema = z.object({
3976
- tradeIds: z.array(z.string()),
3977
- settlementTx: z.string(),
3978
- signature: z.string(),
3979
- startIndex: z.number(),
3980
- pmmId: z.string(),
3981
- signedAt: z.number()
3976
+ tradeIds: z.array(z.string()).nullable(),
3977
+ settlementTx: z.string().optional().default(""),
3978
+ signature: z.string().optional().default("0x"),
3979
+ startIndex: z.number().optional().default(0),
3980
+ pmmId: z.string().optional().default(""),
3981
+ signedAt: z.number().optional().default(0)
3982
3982
  });
3983
3983
  var TradeDetailResponseSchema = z.object({
3984
3984
  data: z.object({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optimex-xyz/market-maker-sdk",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"