# Assign a Regular Key Pair The XRP Ledger allows an account to authorize a secondary key pair, called a *[regular key pair](/docs/concepts/accounts/cryptographic-keys)*, to sign future transactions. If the private key of a regular key pair is compromised, you can remove or replace it without changing the rest of your [account](/docs/concepts/accounts) and re-establishing its relationships to other accounts. You can also rotate a regular key pair proactively. (Neither of those things is possible for the master key pair of an account, which is intrinsically linked to the account's address.) For more information about master and regular key pairs, see [Cryptographic Keys](/docs/concepts/accounts/cryptographic-keys). This tutorial walks through the steps required to assign a regular key pair to your account: 1. [Generate a key pair](#1-generate-a-key-pair) 2. [Assign the key pair to your account as a regular key pair](#2-assign-the-key-pair-to-your-account-as-a-regular-key-pair) 3. [Verify the regular key pair](#3-verify-the-regular-key-pair) 4. [Explore next steps](#see-also) ## 1. Generate a Key Pair Generate a key pair that you'll assign to your account as a regular key pair. This key pair is the same data type as a master key pair, so you can generate it the same way: you can use the client library of your choice or use the [wallet_propose method](/docs/references/http-websocket-apis/admin-api-methods/key-generation-methods/wallet_propose) of a server you run. This might look as follows: WebSocket ```json // Request: { "command": "wallet_propose" } // Response: { "result": { "account_id": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "key_type": "secp256k1", "master_key": "KNEW BENT LYNN LED GAD BEN KENT SHAM HOBO RINK WALT ALLY", "master_seed": "sh8i92YRnEjJy3fpFkL8txQSCVo79", "master_seed_hex": "966C0F68643EFBA50D58D191D4CA8AA7", "public_key": "aBRNH5wUurfhZcoyR6nRwDSa95gMBkovBJ8V4cp1C1pM28H7EPL1", "public_key_hex": "03AEEFE1E8ED4BBC009DE996AC03A8C6B5713B1554794056C66E5B8D1753C7DD0E" }, "status": "success", "type": "response" } ``` JSON-RPC ```json // Request: { "method": "wallet_propose" } // Response: { "result": { "account_id": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "key_type": "secp256k1", "master_key": "KNEW BENT LYNN LED GAD BEN KENT SHAM HOBO RINK WALT ALLY", "master_seed": "sh8i92YRnEjJy3fpFkL8txQSCVo79", "master_seed_hex": "966C0F68643EFBA50D58D191D4CA8AA7", "public_key": "aBRNH5wUurfhZcoyR6nRwDSa95gMBkovBJ8V4cp1C1pM28H7EPL1", "public_key_hex": "03AEEFE1E8ED4BBC009DE996AC03A8C6B5713B1554794056C66E5B8D1753C7DD0E", "status": "success" } } ``` Commandline ```sh $ rippled wallet_propose { "result" : { "account_id" : "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "key_type" : "secp256k1", "master_key" : "KNEW BENT LYNN LED GAD BEN KENT SHAM HOBO RINK WALT ALLY", "master_seed" : "sh8i92YRnEjJy3fpFkL8txQSCVo79", "master_seed_hex" : "966C0F68643EFBA50D58D191D4CA8AA7", "public_key" : "aBRNH5wUurfhZcoyR6nRwDSa95gMBkovBJ8V4cp1C1pM28H7EPL1", "public_key_hex" : "03AEEFE1E8ED4BBC009DE996AC03A8C6B5713B1554794056C66E5B8D1753C7DD0E", "status" : "success" } } ``` Python ```py keypair = xrpl.wallet.Wallet.create() print("seed:", keypair.seed) print("classic address:", keypair.address) ``` JavaScript ```js const keypair = new xrpl.Wallet() console.log("seed:", keypair.seed) console.log("classic address:", keypair.classicAddress) ``` Java ```java WalletFactory walletFactory = DefaultWalletFactory.getInstance(); Wallet keypair = walletFactory.randomWallet(true).wallet(); System.out.println(keypair); System.out.println(keypair.privateKey().get()); ``` In the next step, you'll use the address from this response (`account_id` in the API response) to assign the key pair as a regular key pair to your account. Also, save the seed value from this key pair (`master_seed` in the API response) somewhere securely; you'll use that key to sign transactions later. (Everything else, you can forget about.) ## 2. Assign the Key Pair to Your Account as a Regular Key Pair Use a [SetRegularKey transaction](/docs/references/protocol/transactions/types/setregularkey) to assign the key pair you generated in step 1 to your account as a regular key pair. When assigning a regular key pair to your account for the first time, the SetRegularKey transaction requires signing with your account's master private key (secret). There are [several ways of securely signing transactions](/docs/concepts/transactions/secure-signing), but this tutorial uses a local `rippled` server. When you send later SetRegularKey transactions, you can sign using the existing regular private key to replace or [remove itself](/docs/tutorials/how-tos/manage-account-settings/change-or-remove-a-regular-key-pair). Note that you should still not submit your regular private key across the network. ### Sign Your Transaction The most secure way to sign a transaction is to [sign locally with a client library](/docs/concepts/transactions/secure-signing#local-signing-example). Alternatively, if you run your own `rippled` node you can sign the transaction using the [sign method](/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign), but this must be done through a trusted and encrypted connection, or through a local (same-machine) connection. In all cases, note the signed transaction's identifying hash for later. Populate the request fields with the following values: | Request Field | Value | | --- | --- | | `Account` | The address of your account. | | `RegularKey` | `account_id` generated in step 1. | | `secret` | `master_key`, `master_seed`, or `master_seed_hex` (master private key) for your account. | #### Request Format An example of the request format: WebSocket ```json { "command": "sign", "tx_json": { "TransactionType": "SetRegularKey", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7" }, "secret": "ssCATR7CBvn4GLd1UuU2bqqQffHki" } ``` JSON-RPC ```json { "method": "sign", "params": [ { "tx_json": { "TransactionType": "SetRegularKey", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7" }, "secret": "ssCATR7CBvn4GLd1UuU2bqqQffHki" } ] } ``` Commandline ```sh #Syntax: sign secret tx_json rippled sign ssCATR7CBvn4GLd1UuU2bqqQffHki '{"TransactionType": "SetRegularKey", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7"}' ``` #### Response Format An example of a successful response: WebSocket ```json { "result": { "tx_blob": "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence": 4, "SigningPubKey": "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType": "SetRegularKey", "TxnSignature": "304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C26", "hash": "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } }, "status": "success", "type": "response" } ``` JSON-RPC ```json { "result": { "status": "success", "tx_blob": "1200052280000000240000000768400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402201453CA3D4D17F0EE3828B9E3D6ACF65327F5D4FC2BA30953CACF6CBCB4145E3502202F2154BED1D7462CAC1E3DBB31864E48C3BA0B3133ACA5E37EC54F0D0C339E2D8114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence": 4, "SigningPubKey": "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType": "SetRegularKey", "TxnSignature": "304402201453CA3D4D17F0EE3828B9E3D6ACF65327F5D4FC2BA30953CACF6CBCB4145E3502202F2154BED1D7462CAC1E3DBB31864E48C3BA0B3133ACA5E37EC54F0D0C339E2D", "hash": "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } } } ``` Commandline ```json { "result" : { "status" : "success", "tx_blob" : "1200052280000000240000000768400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402201453CA3D4D17F0EE3828B9E3D6ACF65327F5D4FC2BA30953CACF6CBCB4145E3502202F2154BED1D7462CAC1E3DBB31864E48C3BA0B3133ACA5E37EC54F0D0C339E2D8114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json" : { "Account" : "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee" : "10", "Flags" : 2147483648, "RegularKey" : "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence" : 4, "SigningPubKey" : "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType" : "SetRegularKey", "TxnSignature" : "304402201453CA3D4D17F0EE3828B9E3D6ACF65327F5D4FC2BA30953CACF6CBCB4145E3502202F2154BED1D7462CAC1E3DBB31864E48C3BA0B3133ACA5E37EC54F0D0C339E2D", "hash" : "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } } } ``` The `sign` command response contains a `tx_blob` value, as shown above. The offline signing response contains a `signedTransaction` value. Both are signed binary representations (blobs) of the transaction. Next, use the `submit` command to send the transaction blob (`tx_blob` or `signedTransaction`) to the network. ### Submit Your Transaction Take the `signedTransaction` value from the offline signing response or the `tx_blob` value from the `sign` command response and submit it as the `tx_blob` value using the [submit method](/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit). #### Request Format An example of the request format: WebSocket ```json { "command": "submit", "tx_blob": "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540" } ``` JSON-RPC ```json { "method":"submit", "params": [ { "tx_blob": "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540" } ] } ``` Commandline ```sh #Syntax: submit tx_blob rippled submit 1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540 ``` #### Response Format An example of a successful response: WebSocket ```json { "result": { "engine_result": "tesSUCCESS", "engine_result_code": 0, "engine_result_message": "The transaction was applied. Only final in a validated ledger.", "tx_blob": "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence": 4, "SigningPubKey": "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType": "SetRegularKey", "TxnSignature": "304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C26", "hash": "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } }, "status": "success", "type": "response" } ``` JSON-RPC ```json { "result": { "engine_result": "tesSUCCESS", "engine_result_code": 0, "engine_result_message": "The transaction was applied. Only final in a validated ledger.", "status": "success", "tx_blob": "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "RegularKey": "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence": 4, "SigningPubKey": "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType": "SetRegularKey", "TxnSignature": "304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C26", "hash": "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } } } ``` Commandline ```json { "result" : { "engine_result" : "tesSUCCESS", "engine_result_code" : 0, "engine_result_message" : "The transaction was applied. Only final in a validated ledger.", "status" : "success", "tx_blob" : "1200052280000000240000000468400000000000000A73210384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A7446304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C268114830923439D307E642CED308FD91EF701A7BAA74788141620D685FB08D81A70D0B668749CF2E130EA7540", "tx_json" : { "Account" : "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee" : "10", "Flags" : 2147483648, "RegularKey" : "rsprUqu6BHAffAeG4HpSdjBNvnA6gdnZV7", "Sequence" : 4, "SigningPubKey" : "0384CA3C528F10C75F26E0917F001338BD3C9AA1A39B9FBD583DFFFD96CF2E2D7A", "TransactionType" : "SetRegularKey", "TxnSignature" : "304402204BCD5663F3A2BA02D2CE374439096EC6D27273522CD6E6E0BDBFB518730EAAE402200ECD02D8D2525D6FA4642613E71E395ECCEA01C42C35A668BF092A00EB649C26", "hash" : "AB73BBF7C99061678B59FB48D72CA0F5FC6DD2815B6736C6E9EB94439EC236CE" } } } ``` Note that the response contains a `hash` of the transaction, which you can use to [look up the transaction's final outcome](/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx). ## 3. Verify the Regular Key Pair At this point, the regular key pair is assigned to your account and you should be able to send transactions using the regular key pair. **To avoid losing control of your account,** it is important that you test your regular key before you take any additional steps such as [disabling the master key pair](/docs/tutorials/how-tos/manage-account-settings/disable-master-key-pair). If you make a mistake and lose access to your account, no one can restore it for you. To verify that your account has the regular key pair set correctly, submit an [AccountSet transaction](/docs/references/protocol/transactions/types/accountset) from your account, signing it with the regular private key you assigned to your account in step 2. As in step 1, this tutorial uses a local `rippled` server as a [way of securely signing transactions](/docs/concepts/transactions/secure-signing). ### Sign Your Transaction The most secure way to sign a transaction is to [sign locally with a client library](/docs/concepts/transactions/secure-signing#local-signing-example). Alternatively, if you run your own `rippled` node you can sign the transaction using the [sign method](/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign), but this must be done through a trusted and encrypted connection, or through a local (same-machine) connection. In all cases, note the signed transaction's identifying hash for later. Populate the request fields with the following values: | Request Field | Value | | --- | --- | | `Account` | The address of your account. | | `secret` | `master_key`, `master_seed`, or `master_seed_hex` (regular private key) generated in step 1 and assigned to your account in step 2. | #### Request Format Here's an example of the request format. Note that the request does not include any `AccountSet` options. This means that a successful transaction has no effect other than to confirm that the regular key pair is set correctly for your account (and to destroy the transaction cost). WebSocket ```json { "command": "sign", "tx_json": { "TransactionType": "AccountSet", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93" }, "secret": "sh8i92YRnEjJy3fpFkL8txQSCVo79" } ``` JSON-RPC ```json { "method": "sign", "params": [ { "tx_json": { "TransactionType": "AccountSet", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93" }, "secret": "sh8i92YRnEjJy3fpFkL8txQSCVo79" } ] } ``` Commandline ```sh #Syntax: sign secret tx_json rippled sign sh8i92YRnEjJy3fpFkL8txQSCVo79 '{"TransactionType": "AccountSet", "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93"}' ``` #### Response Format An example of a successful response: WebSocket ```json { "result": { "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "Sequence": 4, "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType": "AccountSet", "TxnSignature": "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash": "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } }, "status": "success", "type": "response" } ``` JSON-RPC ```json { "result": { "status": "success", "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "Sequence": 4, "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType": "AccountSet", "TxnSignature": "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash": "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } } } ``` Commandline ```json { "result" : { "status" : "success", "tx_blob" : "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json" : { "Account" : "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee" : "10", "Flags" : 2147483648, "Sequence" : 4, "SigningPubKey" : "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType" : "AccountSet", "TxnSignature" : "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash" : "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } } } ``` The `sign` command response contains a `tx_blob` value, as shown above. The offline signing response contains a `signedTransaction` value. Both are signed binary representations (blobs) of the transaction. Next, use the `submit` command to send the transaction blob (`tx_blob` or `signedTransaction`) to the network. ### Submit Your Transaction Take the `signedTransaction` value from the offline signing response or the `tx_blob` value from the `sign` command response and submit it as the `tx_blob` value using the [submit method](/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit). #### Request Format An example of the request format: WebSocket ```json { "command": "submit", "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E" } ``` JSON-RPC ```json { "method":"submit", "params": [ { "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E" } ] } ``` Commandline ```sh #Syntax: submit tx_blob rippled submit 1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E ``` #### Response Format An example of a successful response: WebSocket ```json { "result": { "engine_result": "tesSUCCESS", "engine_result_code": 0, "engine_result_message": "The transaction was applied. Only final in a validated ledger.", "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "Sequence": 4, "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType": "AccountSet", "TxnSignature": "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash": "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } }, "status": "success", "type": "response" } ``` JSON-RPC ```json { "result": { "engine_result": "tesSUCCESS", "engine_result_code": 0, "engine_result_message": "The transaction was applied. Only final in a validated ledger.", "status": "success", "tx_blob": "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json": { "Account": "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee": "10", "Flags": 2147483648, "Sequence": 4, "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType": "AccountSet", "TxnSignature": "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash": "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } } } ``` Commandline ```json { "result" : { "engine_result" : "tesSUCCESS", "engine_result_code" : 0, "engine_result_message" : "The transaction was applied. Only final in a validated ledger.", "status" : "success", "tx_blob" : "1200032280000000240000000468400000000000000A73210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB88114623B8DA4A0BFB3B61AB423391A182DC693DC159E", "tx_json" : { "Account" : "rUAi7pipxGpYfPNg3LtPcf2ApiS8aw9A93", "Fee" : "10", "Flags" : 2147483648, "Sequence" : 4, "SigningPubKey" : "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020", "TransactionType" : "AccountSet", "TxnSignature" : "3045022100A50E867D3B1B5A39F23F1ABCA5C7C3EC755442FDAA357EFD897B865ACA7686DB02206077BF459BCE39BCCBFE1A128DA986D1E00CBEC5F0D6B0E11710F60BE2976FB8", "hash" : "D9B305CB6E861D0994A5CDD4726129D91AC4277111DC444DE4CEE44AD4674A9F" } } } ``` If the transaction fails with the following [result codes](/docs/references/protocol/transactions/transaction-results), here are some things to check: - **`tefBAD_AUTH`**: The regular key you signed your test transaction with doesn't match the regular key you set in the previous step. Check that the secret and address for your regular key pair match and double-check which values you used in each step. - **`tefBAD_AUTH_MASTER`** or **`temBAD_AUTH_MASTER`**: Your account doesn't have a regular key assigned. Check that the SetRegularKey transaction executed successfully. You can also use the [account_info method](/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info) to confirm that your regular key is set in the `RegularKey` field as expected. For possible causes of other result codes, see [Transaction Results](/docs/references/protocol/transactions/transaction-results). ## See Also Now that you're familiar with the benefits of assigning a regular key pair to an account, consider taking a look at these related topics and tutorials: - **Concepts:** - [Cryptographic Keys](/docs/concepts/accounts/cryptographic-keys) - [Multi-Signing](/docs/concepts/accounts/multi-signing) - [Issuing and Operational Addresses](/docs/concepts/accounts/account-types) - **Tutorials:** - [Change or Remove a Regular Key Pair](/docs/tutorials/how-tos/manage-account-settings/change-or-remove-a-regular-key-pair) - [Set Up Multi-Signing](/docs/tutorials/how-tos/manage-account-settings/set-up-multi-signing) - [List XRP as an Exchange](/docs/use-cases/defi/list-xrp-as-an-exchange) - **References:** - [wallet_propose method](/docs/references/http-websocket-apis/admin-api-methods/key-generation-methods/wallet_propose) - [sign method](/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign) - [SetRegularKey transaction](/docs/references/protocol/transactions/types/setregularkey) - [AccountRoot object](/docs/references/protocol/ledger-data/ledger-entry-types/accountroot) where the regular key is stored in the field `RegularKey`