Update account EDDSA key
流量控制: 每 秒
摘要
HTTP 方法
POST
访问路径
/api/v3/account
功能
Updates the EDDSA key associated with the specified account, making the previous one invalid in the process.
API 描述
HTTP头
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| X-API-KEY | string | 是 | ApiKey | "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ 6B6DQ6THZWbvrAGxzEdulXQvOKLrRW ZLnN" |
| X-API-SIG | string | 是 | ECDSA 签名信息 | "0xccf0a141fce2dc5cbbd4f802c52220e9 e2ce260e86704d6258603eb346eefe2d 4a450005c362b223b28402d087f7065e a5eee0314531adf6a580fce64c25dca81c02" |
请求参数
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| exchange | string | 是 | exchange address | "1" |
| owner | string | 是 | owner address | "0xB4A70168340C751195 23019f79F5Ffd9c60Dce C7" |
| accountId | integer | 是 | user account ID | 1 |
| publicKey | string | 是 | The user's public key | "0xABCD" |
| maxFee | TokenVolumeV3 | 是 | maximum of fee token | "{tokenId: 0, volume: 1000000}" |
| validUntil | integer | 是 | Timestamp for order to become invalid | 1583183141 |
| nonce | integer | 是 | Nonce of users exchange account that used in off-chain requests. | 1 |
| eddsaSignature | string | 否 | eddsa signature of this request | "0xccf0a141fce2dc5cbb d4f802c52220e9e2ce26 0e86704d6258603eb346 eefe2d4a450005c362b2 23b28402d087f7065ea5 eee0314531adf6a580fc e64c25dca81c02" |
| ecdsaSignature | string | 否 | ecdsa signature of this request | "0xeb14773e8a07d19bc4 fe56e36d041dcb002652 f7e92160deaf5e6bf21e 05c7a9eb14773e8a07d1 9bc4fe56e36d041dcb00 2652f7e92160deaf5e6b f21e05c7a9eb14773e8a 07d19bc4fe56e36d041d cb002652f7e92160deaf 5e6bf21e05c7a9" |
| hashApproved | string | 否 | An approved hash string which was submitted on eth mainnet | "0xf7c932351186c3a905 3f313eefa16209c018f7 f1dba8aa8ca7100400f7 c31085" |
请求示例
HTTP
CURL
POST http://aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com/api/v3/account HTTP/1.1
Host: aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
X-API-SIG: dkkfinfasdf
Content-Type: application/json
{
"exchange" : "1",
"owner" : "0xB4A70168340C75119523019f79F5Ffd9c60DceC7",
"accountId" : 1,
"publicKey" : "0xABCD",
"maxFee" : {
"tokenId" : "0",
"volume" : "1000000000000"
},
"validUntil" : 1583183141,
"nonce" : 1,
"eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
"ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
"hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"
}curl -X POST -H "X-API-KEY:sra1aavfa" -H "X-API-SIG:dkkfinfasdf" -H "Content-Type:application/json" http://aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com/api/v3/account -d \
'{
"exchange" : "1",
"owner" : "0xB4A70168340C75119523019f79F5Ffd9c60DceC7",
"accountId" : 1,
"publicKey" : "0xABCD",
"maxFee" : {
"tokenId" : "0",
"volume" : "1000000000000"
},
"validUntil" : 1583183141,
"nonce" : 1,
"eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
"ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
"hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"
}'响应字段
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| hash | string | 是 | The order hash identifier set by the user at the time of submission | "0x1d923ca7834dc90484 fa2eb611f0f0bc7e741b b107007ebea19ba8caea b4f9d3" |
| status | string | 是 | Whether the order was successfully submitted or not, please note, user may query after a while to get real process status, as most offchain requests are async processed 取值范围 : ['received', 'processing', 'processed', 'failed'] |
"received" |
| isIdempotent | boolean | 是 | Idempotent of submit order response, submit same order again when order was UNKNOWN or WAIT_FREEZE_BALANCE in relayer, idempotent will be true 取值范围 : [True, False] |
"true" |
响应示例
{
"hash" : "0x1d923ca7834dc90484fa2eb611f0f0bc7e741bb107007ebea19ba8caeab4f9d3",
"status" : "received",
"isIdempotent" : true
}
状态码
| 状态码 | 描述 |
|---|---|
| 100000 | Unknown error |
| 102001 | Exchange ID is incorrect |
| 102021 | Nonce is invalid |
| 102022 | Transfer sender is invalid |
| 102023 | Transfer receiver is invalid |
| 102024 | Fee token is unsupported |
| 102025 | Transfer token isnt consistent with fee token |
模型
TokenVolumeV3
Wrapper object used to describe a token associated with a certain quantity.
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| tokenId | string | 是 | The Loopring's token identifier. | "0" |
| volume | string | 否 | The volume of the token | "1000000000000" |