 # Aptos Improvement Proposals (AIPs) > Learn about Aptos Improvement Proposals - how the community proposes changes and improvements to the Aptos protocol Aptos Improvement Proposals (AIPs) are a way for the Aptos community to propose changes, improvements, and new features to the Aptos protocol. AIPs are designed to be a collaborative process that allows anyone in the community to contribute ideas and feedback. AIPs are documented in the [AIPs repository](https://github.com/aptos-foundation/AIPs) and are administered by the Aptos Foundation. Each AIP is assigned a unique number and goes through a rigorous review process before it is accepted or rejected. ## What do AIPs cover? AIPs can cover a wide range of topics, including: - Node protocol changes - Mempool changes, consensus changes, etc. - Framework (smart contract) changes - New modules, new functions, etc. - Governance changes - Changes to the way the Aptos Foundation operates, changes to the way AIPs are processed, etc. ## What is this section of the docs mostly about? This section of the docs is mostly about AIPs that are relevant to developers and providing FAQs and quick information about them. # AIP-115: Stateless Accounts > Learn about AIP-115 which introduces stateless accounts that operate without explicitly created Account resources [AIP-115](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-115.md) covers stateless accounts. ## General FAQ ### What is a Stateless Account? A Stateless Account is a new behavior for Aptos accounts that allows them to operate without requiring an explicitly created `0x1::account::Account` resource. Instead, these accounts use default behaviors until an action necessitates the creation of the resource. This change simplifies account management and reduces unnecessary resource creation, making it easier for developers and users to interact with the Aptos blockchain. ### How is it different from a regular account? Technically, there is no separate account type. All accounts are the same under the hood. The difference is that accounts without a resource behave in a "stateless" manner using default values. The account resource is only created on-demand when needed. ### How does it work? When an account signs its first transaction sequence number transaction, it will not have the `0x1::account::Account` resource created. Instead, it will create the `0x1::account::Account` resource only when an action that requires to increment the sequence number. For an orderless transaction, the account resource is not needed at all, and the account resource will not be created. ## Technical Details FAQ ### What is the default auth\_key for Stateless Accounts? If the `0x1::account::Account` resource does not exist, the auth\_key defaults to the account address itself. This allows the account to sign and submit transactions without needing a resource. ### What is the sequence number of a Stateless Account? It defaults to `0` if the account resource does not exist. In the future, with Orderless Transactions, the sequence number may be eliminated entirely. ### When is the account resource automatically created? The resource is created when an action that requires on-chain state, such as: - Rotating the authentication key - Using capabilities or features that rely on the account resource such as sequence number - Explicitly calling functions that access fields in the account resource ### Does creating the account resource incur extra gas cost? Yes. The creation of the resource is deferred, and the corresponding gas and storage fees are only charged at the moment of actual creation, not beforehand. ### Any behavior change to account module at the Move level? `0x1::account::exists_at` always returns true, as all on-chain account addresses are considered valid and treated as existing by default. There is no move function in the module to check whether the underlying account resource really exists since the goal is to make it transparent to users. As a result, any logic that first checks whether an account exists before attempting to create it is now obsolete. ### Can users force-create the account resource upfront? Yes. Users can explicitly call functions like `0x1::account::create_account_if_does_not_exist` to create the resource manually, if desired. ### Any behavior change to API? If you rely on the following API behavior, please adjust correspondingly. `GET /accounts/{address}` will never return “404 not found” but the default authentication key and sequence number mentioned above for stateless accounts. Therefore, if it is desired to check whether the account resource exists or not, try `GET /accounts/{address}/resource/0x1::account::Account` ### Do existing accounts get affected? No. Existing accounts with resources already created will continue to work exactly as they do now. Stateless Account behavior only applies to accounts that have not yet created a resource. ### Do dApps / CEX need to change anything? Maybe. Previously, checking whether an account existed often relied on calling APIs that return a 404 error if the account resource was not found. Applications would then use this as a signal to warn users (e.g., "This account does not exist"). Under the new model, all addresses are considered valid, and such 404-based existence checks are no longer reliable or meaningful. However, we are not banning this pattern—developers may still choose to warn users that an account may not have performed any on-chain activity and thus might not have a resource created yet. If you still want to detect whether an account has an associated resource, you can refer to the method described in Q9 or check whether the sequence\_number is 0\. But be aware that with the introduction of orderless transactions, some accounts may only submit transactions that never create a resource, which could result in false negatives. We recommend designing your application to be robust regardless of whether the account resource exists, and to avoid assuming resource presence as a proxy for account existence. Examples: - A wallet might check for an account to see if it’s a new account, and provide a user a warning. With this change, instead a mitigation like Q9 will be needed. - A custodial wallet may send funds to initialize an account with gas. With this change, it will need to check the account’s balance instead of just the account existing. ### Is this compatible with Orderless Transactions? Yes. Orderless Transactions and Stateless Accounts are complementary. Once Orderless Transactions are enabled, sequence numbers will no longer be needed, enabling truly stateless usage. ## Will all accounts become Stateless in the future? No. Stateless Accounts are not a new account type. It simply allows accounts to behave with default logic until the account resource is needed. This lazy resource creation, does not transform existing account state. All accounts can behave in a stateless way by default, but they will still create the standard resource if and when advanced features are used. # AIP-88: Block Epilogue Transactions > Understanding AIP-88 which introduces block epilogue transactions to provide information about executed blocks [AIP-88](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-88.md) covers block epilogue transactions, which are a new type of transaction that give information about the block after it has been executed. These transactions can only be created by the consensus and are not user-initiated. They contain information about gas usage in the block and will contain more information in the future. It replaces the previous `StateCheckpoint` transaction type, which was used to "sometimes" signal the end of a block. The new `BlockEpilogue` transaction is now sometimes created at the end of a block instead, and it is guaranteed to be the last transaction in the block. The only case this does not apply is the last block of an epoch, which will have no `BlockEpilogue` transaction. ## General FAQ ### What is in the Block Epilogue Transaction? The block epilogue transaction contains a `BlockEndInfo` enum. It is purposely designed to be an enum so that it can be extended in the future without breaking existing code. The current version is `V0` and contains the following fields: ```move module 0x1::epilogue { enum BlockEndInfo { V0 { /// Whether block gas limit was reached block_gas_limit_reached: bool, /// Whether block output limit was reached block_output_limit_reached: bool, /// Total gas_units block consumed block_effective_block_gas_units: u64, /// Total output size block produced block_approx_output_size: u64, }, } } ``` These mainly contain information about the gas usage in the block for debugging purposes. The JSON output will look like this: ```json { "version":"1912", "hash":"0x54a8efc93fc94f5b545dadb63da3d4dc192125c717b336dc446d55a5b553913f", "state_change_hash":"0xafb6e14fe47d850fd0a7395bcfb997ffacf4715e0f895cc162c218e4a7564bc6", "event_root_hash":"0x414343554d554c41544f525f504c414345484f4c4445525f4841534800000000", "state_checkpoint_hash":"0x841a43956ca09a02b1c1cdadc65f24c390170aa666015a2e8f7ec5c9d6a3875f", "gas_used":"0", "success":true, "vm_status":"Executed successfully", "accumulator_root_hash":"0x6561976b4560ff25239dffc6cada70e7008dd42fc4d3df2eca6a86b6d2ec384d", "changes":[], "timestamp":"1719263322836578", "block_end_info": { "block_gas_limit_reached":false, "block_output_limit_reached":false, "block_effective_block_gas_units":0, "block_approx_output_size":1163 }, "type":"block_epilogue_transaction" } ``` ## Compatibility FAQ ### What does this mean for my dApp? If you process transactions in your dApp, and expect the last transaction in a block to be a `StateCheckpoint`, you will need to update your code to handle the `BlockEpilogue` transaction instead. Note that, the `BlockEpilogue` transaction is guaranteed to be the last transaction of a block except for the last block of an epoch, which will not have a `BlockEpilogue` transaction. ### What apps are likely to be affected? Apps that index all transactions such as block explorers and centralized exchange indexer processors may be affected. However, most of these are informational and do not affect the core functionality of the dApp. ### What can I do to process the new transaction type? If you're using the Aptos Go SDK or the Aptos TypeScript SDK, you can update to the latest version, which will automatically handle the new transaction type. # Aptos APIs > Access the Aptos blockchain through various APIs including REST API, GraphQL, and specialized endpoints for different use cases import { CardGrid, LinkCard } from '@astrojs/starlight/components'; The Aptos Blockchain network can be accessed by several APIs, depending on your use-case. ## Aptos Fullnode This API - embedded into Fullnodes - provides a simple, low latency, yet low-level way of _reading_ state and _submitting_ transactions to the Aptos Blockchain. It also supports transaction simulation.
Output
```shellscript Got 1/1 txns from RestApi. Replaying transaction... { "Result": { "transaction_hash": "0x1ba73d03a0442a845735a17c7be46f3b51e2acb0e5cf68749305c5a17539ac63", "gas_used": 7, "gas_unit_price": 100, "sender": "c94e16736910cc160347d01de345407fe2d350fce5635ac1150319b0fbf5630e", "sequence_number": 14637, "success": true, "version": 581400718, "vm_status": "status EXECUTED of type Execution" } } ```Output
```shellscript Got 1/1 txns from RestApi. Benchmarking transaction... Running time (cold code cache): 914.821µs Running time (warm code cache): 820.189µs { "Result": { "transaction_hash": "0x1ba73d03a0442a845735a17c7be46f3b51e2acb0e5cf68749305c5a17539ac63", "gas_used": 7, "gas_unit_price": 100, "sender": "c94e16736910cc160347d01de345407fe2d350fce5635ac1150319b0fbf5630e", "sequence_number": 14637, "success": true, "version": 581400718, "vm_status": "status EXECUTED of type Execution" } } ```Output
```shellscript Got 1/1 txns from RestApi. Profiling transaction... Gas report saved to gas-profiling/txn-1ba73d03-0x1-aptos_account-transfer. { "Result": { "transaction_hash": "0x1ba73d03a0442a845735a17c7be46f3b51e2acb0e5cf68749305c5a17539ac63", "gas_used": 7, "gas_unit_price": 100, "sender": "c94e16736910cc160347d01de345407fe2d350fce5635ac1150319b0fbf5630e", "sequence_number": 14637, "success": true, "version": 581400718, "vm_status": "status EXECUTED of type Execution" } } ```# Starting A Local Network
Common Errors On Network Startup
### Address Already In Use ```shellscript filename="Terminal" panicked at 'error binding to 0.0.0.0:8080: error creating server listener: Address already in use (os error 48)' ``` This means one of the ports needed by the local network is already in use by another process. To fix this on Unix systems, you can: 1. Identify the name and PID of the process by running `lsof -i :8080`. 2. Run `killLinux / macOS
1. Open a Terminal session. 2. Run the dev setup script to prepare your environment: `./scripts/dev_setup.sh -yp` 3. Update your current shell environment: `source ~/.profile`Windows
1. Open a PowerShell terminal as an administrator. 2. Run the dev setup script to prepare your environment: `PowerShell -ExecutionPolicy Bypass -File ./scripts/windows_dev_setup.ps1 -y`Example output
```shellscript filename="Terminal" { "Result": { "PublicKey Path": "private-key-a.pub", "PrivateKey Path": "private-key-a", "Account Address:": "0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5" } } ```Example output
```shellscript filename="Terminal" Configuring for profile hot-wallet-1 Configuring for network Local Using command line argument for private key Account 0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5 doesn\'t exist, creating it and funding it with 100000000 Octas Account 0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5 funded successfully --- Aptos CLI is now set up for account 0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5 as profile hot-wallet-1! Run `aptos --help` for more information about commands { "Result": "Success" } ```Example output
```shellscript filename="Terminal" { "Result": { "message": "Saved new profile ledger-wallet-1000", "transaction": { "transaction_hash": "0x1a6df99651ac170bda10cfb9898fa196321d80a928033791b9d2231f77738bb2", "gas_used": 448, "gas_unit_price": 100, "sender": "aaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5", "sequence_number": 0, "success": true, "timestamp_us": 1717986382369736, "version": 186, "vm_status": "Executed successfully" } } } ```Example output
```shellscript filename="Terminal" { "Result": { "hot-wallet-1": { "has_private_key": true, "public_key": "0xffb1240fd1267207cc3ed2e1b5386e090a9ca2c844d7f9e0077b3d7dd5d5e430", "account": "aaa271bca468fb8518f73a732a484b29a1bc296ebcb23f15639d4865a5cebe87", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } { "Result": { "ledger-wallet-1000": { "has_private_key": false, "public_key": "0x20ba83f9b9fdab73b0ace8fda26ce24c98cf55060b72b69cfbd25add6a25d09b", "account": "aaa271bca468fb8518f73a732a484b29a1bc296ebcb23f15639d4865a5cebe87", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } ```Example output
```shellscript filename="Terminal" { "Result": "Deleted profile hot-wallet-1" } { "Result": "Deleted profile ledger-wallet-1000" } ```Example output
```shellscript filename="Terminal" Configuring for profile ledger-wallet-1000-recovered Configuring for network Local Account 0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5 has been already found onchain --- Aptos CLI is now set up for account 0xaaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5 as profile ledger-wallet-1000-recovered! Run `aptos --help` for more information about commands { "Result": "Success" } ```Example output
```shellscript filename="Terminal" { "Result": { "ledger-wallet-1000-recovered": { "has_private_key": false, "public_key": "0x20ba83f9b9fdab73b0ace8fda26ce24c98cf55060b72b69cfbd25add6a25d09b", "account": "aaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } ```Example output
```shellscript filename="Terminal" { "Result": { "PublicKey Path": "private-key-b.pub", "PrivateKey Path": "private-key-b", "Account Address:": "0xbbbede2b4f1d49eff0b156ab0756889a6f2bb68f215399d5015da9ac45921b47" } } ```Example output
```shellscript filename="Terminal" { "Result": { "message": "Saved new profile temporary-hot-wallet", "transaction": { "transaction_hash": "0xe49782e92d8fd824fd6dce8f6ed42a11cf8ee84c201f3aa639c435e737c80eaa", "gas_used": 449, "gas_unit_price": 100, "sender": "aaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5", "sequence_number": 1, "success": true, "timestamp_us": 1717986617911082, "version": 631, "vm_status": "Executed successfully" } } ```Example output
```shellscript filename="Terminal" { "Result": "Renamed profile ledger-wallet-1000-recovered to ledger-wallet-1000-stale" } ```Example output
```shellscript filename="Terminal" { "Result": { "message": "Saved new profile ledger-wallet-1000", "transaction": { "transaction_hash": "0x9503819d4ea13bcd9eafed25984807d86d22e8a9837565a7495b54d13890d103", "gas_used": 449, "gas_unit_price": 100, "sender": "aaac71af5f2a4af4ec2639a15799bf9b945afb061c8bee102b636531c1b00eb5", "sequence_number": 2, "success": true, "timestamp_us": 1717986672963544, "version": 742, "vm_status": "Executed successfully" } } } ```Example output
```shellscript filename="Terminal" { "Result": "Deleted profile temporary-hot-wallet" } { "Result": "Deleted profile ledger-wallet-1000-stale" } ```Output
```shellscript filename="Terminal" { "Result": { "Account Address:": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "PublicKey Path": "ace.key.pub", "PrivateKey Path": "ace.key" } } ```Output
```shellscript filename="Terminal" { "Result": "Added 100000000 Octas to account acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46" } ```Output
```json filename="Terminal" { "Result": { "transaction_hash": "0x1d7b074dd95724c5459a1c30fe4cb3875e7b0478cc90c87c8e3f21381625bec1", "gas_used": 1294, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 0, "success": true, "timestamp_us": 1685077849297587, "version": 528422121, "vm_status": "Executed successfully" } } ```Output
```json filename="Terminal" { "Result": { "transaction_hash": "0x5e141dc6c28e86fa9f5594de93d07a014264ebadfb99be6db922a929eb1da24f", "gas_used": 504, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 1, "success": true, "timestamp_us": 1685077888820037, "version": 528422422, "vm_status": "Executed successfully" } } ```Output
```json filename="Terminal" { "Result": { "transaction_hash": "0x60a32315bb48bf6d31629332f6b1a3471dd0cb016fdee8d0bb7dcd0be9833e60", "gas_used": 3, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 2, "success": true, "timestamp_us": 1685077961499641, "version": 528422965, "vm_status": "Executed successfully" } } ```Output
```json filename="Terminal" { "Result": [ "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46::cli_args" ] } ```Output
```json filename="Terminal" { "Result": { "transaction_hash": "0x1d644eba8187843cc43919469112339bc2c435a49a733ac813b7bc6c79770152", "gas_used": 3, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 3, "success": true, "timestamp_us": 1685078415935612, "version": 528426413, "vm_status": "Executed successfully" } } ```Output
```json filename="Terminal" { "Result": { "transaction_hash": "0x840e2d6a5ab80d5a570effb3665f775f1755e0fd8d76e52bfa7241aaade883d7", "gas_used": 3, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 4, "success": true, "timestamp_us": 1685078516832128, "version": 528427132, "vm_status": "Executed successfully" } } ```Output
```shellscript { "Result": { "transaction_hash": "0xe4ae0ec4ea3474b2123838885b04d7f4b046c174d14d7dc1c56916f2eb553bcf", "gas_used": 1118, "gas_unit_price": 100, "sender": "dbcbe741d003a7369d87ec8717afb5df425977106497052f96f4e236372f7dd5", "sequence_number": 5, "success": true, "timestamp_us": 1713914742422749, "version": 1033819503, "vm_status": "Executed successfully" } } ```Output
```shellscript Simulating transaction locally... { "Result": { "transaction_hash": "0x5aab20980688185eed2c9a27bab624c84b8b8117241cd4a367ba2a012069f57b", "gas_used": 441, "gas_unit_price": 100, "sender": "dbcbe741d003a7369d87ec8717afb5df425977106497052f96f4e236372f7dd5", "success": true, "version": 1033887414, "vm_status": "status EXECUTED of type Execution" } } ```Output
```shellscript Benchmarking transaction locally... Running time (cold code cache): 985.141µs Running time (warm code cache): 848.159µs { "Result": { "transaction_hash": "0xa2fe548d37f12ee79df13e70fdd8212e37074c1b080b89b7d92e82550684ecdb", "gas_used": 441, "gas_unit_price": 100, "sender": "dbcbe741d003a7369d87ec8717afb5df425977106497052f96f4e236372f7dd5", "success": true, "version": 1033936831, "vm_status": "status EXECUTED of type Execution" } } ```Output
```shellscript Simulating transaction locally using the gas profiler... Gas report saved to gas-profiling/txn-d0bc3422-0xdbcb-message-set_message. { "Result": { "transaction_hash": "0xd0bc342232f14a6a7d2d45251719aee45373bdb53f68403cfc6dc6062c74fa9e", "gas_used": 441, "gas_unit_price": 100, "sender": "dbcbe741d003a7369d87ec8717afb5df425977106497052f96f4e236372f7dd5", "success": true, "version": 1034003962, "vm_status": "status EXECUTED of type Execution" } } ```Output
```shellscript filename="Terminal" { "Result": { "PublicKey Path": "bee.key.pub", "PrivateKey Path": "bee.key", "Account Address:": "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc" } } ```Output
```shellscript filename="Terminal" { "Result": "Added 100000000 Octas to account beec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc" } ```Output
```shellscript filename="Terminal" { "Result": { "multisig_address": "57478da34604655c68b1dcb89e4f4a9124b6c0ecc1c59a0931d58cc4e60ac5c5", "transaction_hash": "0x849cc756de2d3b57210f5d32ae4b5e7d1f80e5d376233885944b6f3cc2124a05", "gas_used": 1524, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 5, "success": true, "timestamp_us": 1685078644186194, "version": 528428043, "vm_status": "Executed successfully" } } ```Output
```shellscript filename="Terminal" { "Result": [ "2" ] } ```Output
```shellscript filename="Terminal" { "Result": [ [ "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46" ] ] } ```Output
```shellscript filename="Terminal" { "Result": [ "0" ] } ```Output
```shellscript filename="Terminal" { "Result": [ "1" ] } ```Output
```shellscript filename="Terminal" { "Result": "Publication payload entry function JSON file saved to publication.json" } ```Output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0x70c75903f8e1b1c0069f1e84ef9583ad8000f24124b33a746c88d2b031f7fe2c", "gas_used": 510, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 6, "success": true, "timestamp_us": 1685078836492390, "version": 528429447, "vm_status": "Executed successfully" } } ```Output
```shellscript filename="Terminal" { "Result": [ "0" ] } ```Output
```shellscript filename="Terminal" { "Result": [ "2" ] } ```Output
```shellscript filename="Terminal" { "Result": [ { "creation_time_secs": "1685078836", "creator": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "payload": { "vec": [] }, "payload_hash": { "vec": [ "0x62b91159c1428c1ef488c7290771de458464bd665691d9653d195bc28e0d2080" ] }, "votes": { "data": [ { "key": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "value": true } ] } } ] } ```Output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0xd0a348072d5bfc5a2e5d444f92f0ecc10b978dad720b174303bc6d91342f27ec", "gas_used": 511, "gas_unit_price": 100, "sender": "beec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "sequence_number": 0, "success": true, "timestamp_us": 1685078954841650, "version": 528430315, "vm_status": "Executed successfully" } } ```Output
```shellscript filename="Terminal" { "Result": [ "3" ] } ```Output
```shellscript filename="Terminal" { "Result": [ [ { "creation_time_secs": "1685078836", "creator": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "payload": { "vec": [] }, "payload_hash": { "vec": [ "0x62b91159c1428c1ef488c7290771de458464bd665691d9653d195bc28e0d2080" ] }, "votes": { "data": [ { "key": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "value": true } ] } }, { "creation_time_secs": "1685078954", "creator": "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "payload": { "vec": [ "0x0057478da34604655c68b1dcb89e4f4a9124b6c0ecc1c59a0931d58cc4e60ac5c508636c695f61726773087365745f76616c7302070000000000000000000000000000000000000000000000000000000000000001076163636f756e74074163636f756e740007000000000000000000000000000000000000000000000000000000000000000108636861696e5f696407436861696e49640003017b0504000100006403020000000000000000000000000000000000000000000000000000000000000ace0000000000000000000000000000000000000000000000000000000000000bee010000000000000000000000000000000000000000000000000000000000000cad00" ] }, "payload_hash": { "vec": [] }, "votes": { "data": [ { "key": "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "value": true } ] } } ] ] } ```Output
```shellscript filename="Terminal" { "Result": [ false ] } ```Output
```shellscript filename="Terminal" { "Result": { "Status": "Transaction match", "Multisig transaction": { "creation_time_secs": "1685078836", "creator": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "payload": { "vec": [] }, "payload_hash": { "vec": [ "0x62b91159c1428c1ef488c7290771de458464bd665691d9653d195bc28e0d2080" ] }, "votes": { "data": [ { "key": "0xacef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "value": true } ] } } } } ```Output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0xa5fb49f1077de6aa6d976e6bcc05e4c50c6cd061f1c87e8f1ea74e7a04a06bd1", "gas_used": 6, "gas_unit_price": 100, "sender": "beec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "sequence_number": 1, "success": true, "timestamp_us": 1685079892130861, "version": 528437204, "vm_status": "Executed successfully" } } ```Output
```shellscript filename="Terminal" { "Result": [ true ] } ```Output
Also pending the resolution of [#8304](https://github.com/aptos-labs/aptos-core/issues/8304), the CLI output for a successful multisig publication transaction execution results in an API error if only the payload hash has been stored on-chain, but the transaction can be manually verified using an explorer.Output
```shellscript filename="Terminal" { "Result": [ false ] } ```Output
```shellscript filename="Terminal" { "Result": { "Status": "Transaction match", "Multisig transaction": { "creation_time_secs": "1685078954", "creator": "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "payload": { "vec": [ "0x0057478da34604655c68b1dcb89e4f4a9124b6c0ecc1c59a0931d58cc4e60ac5c508636c695f61726773087365745f76616c7302070000000000000000000000000000000000000000000000000000000000000001076163636f756e74074163636f756e740007000000000000000000000000000000000000000000000000000000000000000108636861696e5f696407436861696e49640003017b0504000100006403020000000000000000000000000000000000000000000000000000000000000ace0000000000000000000000000000000000000000000000000000000000000bee010000000000000000000000000000000000000000000000000000000000000cad00" ] }, "payload_hash": { "vec": [] }, "votes": { "data": [ { "key": "0xbeec980219d246581cef5166dc6ba5fb1e090c7a7786a5176d111a9029b16ddc", "value": true } ] } } } } ```Output
```shellscript filename="Terminal" { "Error": "Unexpected error: Transaction mismatch: The transaction you provided has a payload hash of 0xe494b0072d6f940317344967cf0e818c80082375833708c773b0275f3ad07e51, but the on-chain transaction proposal you specified has a payload hash of 0x070ed7c3f812f25f585461305d507b96a4e756f784e01c8c59901871267a1580. For more info, see https://aptos.dev/move/move-on-aptos/cli#multisig-governance" } ```Output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0x233427d95832234fa13dddad5e0b225d40168b4c2c6b84f5255eecc3e68401bf", "gas_used": 6, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 7, "success": true, "timestamp_us": 1685080266378400, "version": 528439883, "vm_status": "Executed successfully" } } ```Output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0xbc99f929708a1058b223aa880d04607a78ebe503367ec4dab23af4a3bdb541b2", "gas_used": 505, "gas_unit_price": 100, "sender": "acef1b9b7d4ab208b99fed60746d18dcd74865edb7eb3c3f1428233988e4ba46", "sequence_number": 8, "success": true, "timestamp_us": 1685080344045461, "version": 528440423, "vm_status": "Executed successfully" ```### Comparing Token Standards in Detail | | Solidity | Move (Aptos) | | ---------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Token Structure** | Each token is its own contract. | Every token is a typed `Coin` or `FungibleAsset` using a single, reusable contract. | | **Token Standard** | Must conform to standards like ERC20; implementations can vary. | Uniform interface and implementation for all tokens. | | **Balance Storage** | Balances stored in contract using a mapping structure. | **Resource-Oriented Balance**: Balances stored as a resource in the user's account. Resources cannot be arbitrarily created, ensuring integrity of token value. | | **Transfer Mechanism** | Tokens can be transferred without receiver's explicit permission. | Except for specific cases (like AptosCoin), Tokens generally require receiver's `signer` authority for transfer. |
### Comparing EVM and Move VM in Detail - **EVM**: Known for its flexibility and dynamic dispatch, which allows a wide range of smart contract behaviors. This flexibility, however, can lead to complexities in parallel execution and network operations. - **Move VM**: Focuses on safety and efficiency with a more integrated approach between the VM and the programming language. Its data storage model allows for better parallelization, and its static dispatch method enhances security and predictability.
| | EVM (Ethereum Virtual Machine) | Move VM (Move Virtual Machine) | | ------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | **Data Storage** | Data is stored in the smart contract's storage space. | Data is stored across smart contracts, user accounts, and objects. | | **Parallelization** | Parallel execution is limited due to shared storage space. | More parallel execution enabled due to flexible split storage design. | | **VM and Language Integration** | Separate layers for EVM and smart contract languages (e.g., Solidity). | Seamless integration between VM layer and Move language, with native functions written in Rust executable in Move. | | **Critical Network Operations** | Implementation of network operations can be complex and less direct. | Critical operations like validator set management natively implemented in Move, allowing for direct execution. | | **Function Calling** | Dynamic dispatch allows for arbitrary smart contract calls. | Static dispatch aligns with a focus on security and predictable behavior. | | **Type Safety** | Contract types provide a level of type safety. | Module structs and generics in Move offer robust type safety. | | **Transaction Safety** | Uses nonces for transaction ordering and safety. | Uses sequence numbers for transaction ordering and safety. | | **Authenticated Storage** | Yes, with smart contract storage. | Yes, leveraging Move’s resource model. | | **Object Accessibility** | Objects are not globally accessible; bound to smart contract scope. | Guaranteed global accessibility of objects. | # Solana to Aptos Migration Guide > Detailed comparison and transition guide for Solana developers moving to Aptos blockchain development To learn more about the differences and similarities see [Aptos Learn](https://learn.aptoslabs.com/en/tutorials/solana-to-aptos-guide/cheat-sheet?workshop=solana-to-aptos) | | Solana | Aptos | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Smart Contracts** | Rust, SVM | Move, MoveVM | | **Transaction Fees** | Low | Low | | **Parallelization** | Pessimistic parallelism, need to declare all write accounts | Optimistic parallelism, chain infers write accounts for you | | **Contract Account Support** | PDA Account | [Object](/build/smart-contracts/objects) or [resource account](/build/smart-contracts/resource-accounts)(encourage to use object instead) | | **Data Storage** | Data stored in account owned by programs | Data stored as resource under user account or object | | **Storage Level** | Program level | Global when stored under object | | **Storage Mindset** | User data stored distributedly under account | User data stored distributedly under object | | **Example Code** | [Todo list contract on Solana](https://github.com/aptos-labs/move-by-examples/tree/main/advanced-todo-list/solana) | [Todo list contract on Aptos](https://github.com/aptos-labs/move-by-examples/tree/main/advanced-todo-list/aptos) | | **Caller ID** | `signer` | `signer` | | **Upgradability** | Program is upgradable | Module is upgradable | | **Dispatch Type** | Static dispatch | Static dispatch | | **FT Standards** | Token program | [Coin](/build/smart-contracts/aptos-coin) (legacy) and [Fungible Asset Standard](/build/smart-contracts/fungible-asset) | | **NFT Standards** | Token program | [Digital Asset Standard](/build/smart-contracts/digital-asset) | | **Blockchain Interaction** | Solana web3.js library | [Aptos Typescript SDK](/build/sdks/ts-sdk) | # Learn from Guides > Comprehensive step-by-step tutorials to help you build on Aptos blockchain, from beginner basics to advanced development patterns import { CardGrid, LinkCard } from '@astrojs/starlight/components'; Welcome to Aptos guides! Whether you're just getting started or building advanced applications, these step-by-step tutorials will help you accomplish specific tasks on the Aptos blockchain. ## Beginner Guides Start your journey with these foundational tutorials:
# Federated Keyless > Extended Keyless support for additional OIDC providers through IAM systems like Auth0 and AWS Cognito. ## Federated Keyless [AIP-96](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-96.md): Federated Keyless is an extension of Aptos Keyless to support more OpenID Connect (OIDC) providers, beyond the ones that are allow-listed in `0x1::jwks` via JWK consensus, while maintaining its decentralization. Federated keyless adds support for authenticating users via identity & access management (IAM) providers (e.g. Auth0, AWS Cognito) as long as your project uses a supported IAM provider for user authentication. To elaborate further, Federated Keyless enables: 1. Extension of authentication methods a. All authentication methods supported by the IAM are available to the dApp including email/SMS OTP and their marketplace of social login integrations like Discord, Naver, X and more. Auth0 marketplace linked [here](https://marketplace.auth0.com/) as an example. 2. Compatibility with existing account systems a. Since IAMs also support custom authentication, it allows an application to bring its own username/password (Cognito [docs](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow.html), Auth0 [docs](https://auth0.com/blog/Custom-Authentication-With-Auth0/)). An application can start using an existing account system already set up with an IAM or they can migrate their existing account system to an IAM to generate Keyless-compatible JWTs. - [Federated Keyless Key Considerations](/build/guides/aptos-keyless/federated-keyless/key-considerations) - [Federated Keyless Integration Guide](/build/guides/aptos-keyless/federated-keyless/integration-guide) - [Federated Keyless FAQs](/build/guides/aptos-keyless/federated-keyless/other) # Federated Keyless Integration Guide > Step-by-step guide for integrating Federated Keyless with IAM providers like Auth0 and AWS Cognito. import { Aside, Steps } from '@astrojs/starlight/components';
Example implementation for `storeEphemeralKeyPair`
```typescript filename="ephemeral.ts" /** * Store the ephemeral key pair in localStorage. */ export const storeEphemeralKeyPair = (ekp: EphemeralKeyPair): void => localStorage.setItem("@aptos/ekp", encodeEphemeralKeyPair(ekp)); /** * Retrieve the ephemeral key pair from localStorage if it exists. */ export const getLocalEphemeralKeyPair = (): EphemeralKeyPair | undefined => { try { const encodedEkp = localStorage.getItem("@aptos/ekp"); return encodedEkp ? decodeEphemeralKeyPair(encodedEkp) : undefined; } catch (error) { console.warn( "Failed to decode ephemeral key pair from localStorage", error ); return undefined; } }; /** * Stringify the ephemeral key pairs to be stored in localStorage */ export const encodeEphemeralKeyPair = (ekp: EphemeralKeyPair): string => JSON.stringify(ekp, (_, e) => { if (typeof e === "bigint") return { __type: "bigint", value: e.toString() }; if (e instanceof Uint8Array) return { __type: "Uint8Array", value: Array.from(e) }; if (e instanceof EphemeralKeyPair) return { __type: "EphemeralKeyPair", data: e.bcsToBytes() }; return e; }); /** * Parse the ephemeral key pairs from a string */ export const decodeEphemeralKeyPair = (encodedEkp: string): EphemeralKeyPair => JSON.parse(encodedEkp, (_, e) => { if (e && e.__type === "bigint") return BigInt(e.value); if (e && e.__type === "Uint8Array") return new Uint8Array(e.value); if (e && e.__type === "EphemeralKeyPair") return EphemeralKeyPair.fromBytes(e.data); return e; }); ```# Build an End-to-End Dapp on Aptos > Complete tutorial for building a todo list dapp from smart contract to frontend with wallet integration on Aptos. A common way to learn a new framework or programming language is to build a simple todo list. In this tutorial, we will learn how to build an end-to-end todo list dapp, starting from the smart contract side through the front-end side and finally use of a wallet to interact with the two. See the completed code in the [source-code](https://github.com/aptos-labs/developer-docs/tree/main/apps/nextra/pages/en/build/guides/build-e2e-dapp). ## Chapters After meeting the [prerequisites](#prerequisites) and [getting set up](#setup) as described below, you will follow this tutorial in this order: 1. [Create a smart contract](/build/guides/build-e2e-dapp/1-create-smart-contract) 2. [Set up a frontend](/build/guides/build-e2e-dapp/2-set-up-the-frontend) 3. [Fetch Data from Chain](/build/guides/build-e2e-dapp/3-fetch-data-from-chain) 4. [Submit data to chain](/build/guides/build-e2e-dapp/4-submit-data-to-chain) 5. [Handle Tasks](/build/guides/build-e2e-dapp/5-handle-tasks) ## Prerequisites You must have: - [node and npm](https://nodejs.org/en/) Although we will explain some React decisions, we are not going to deep dive into how React works; so we assume you have some previous experience with React. ## Setup In this section, we will create a `my-first-dapp` directory to hold our project files, both client-side code (React based) and the Move code (our smart contract). For that, we will be using [create-aptos-dapp](/build/create-aptos-dapp) to create the project. 1. Open a terminal and navigate to the desired directory for the project (for example, the `Desktop` directory). 2. Run `npx create-aptos-dapp@latest` to create the project. ```shellscript filename="Terminal" npx create-aptos-dapp@latest ``` 3. Follow the instructions to create the project. - Choose a name for the project, for example `my-first-dapp`. - Choose the `Full-stack project` option. - Choose the `Boilerplate Template` option. - For simplicity, choose not to use Surf. - Choose the `Vite app` framework option. - Choose the `Devnet` network option. The tool will create the project in a directory with the same name as the project and install the required dependencies. Follow the `Next Steps` instructions. Now let's [create a smart contract](/build/guides/build-e2e-dapp/1-create-smart-contract). # 1. Create a Smart Contract > First step in building an end-to-end dapp: create and deploy the Move smart contract for managing todo tasks. import { Aside } from '@astrojs/starlight/components'; This is the first chapter of the tutorial on [building an end-to-end dapp on Aptos](/build/guides/build-e2e-dapp). If you haven’t done it, review that introduction, and ensure your environment meets the [prerequisites](/build/guides/build-e2e-dapp#prerequisites) listed there. Now that you are all set up, let's explore the `contract` directory.  ### What is a `Move.toml` file? A `Move.toml` file is a manifest file that contains metadata such as name, version, and dependencies for the package. Take a look at the new `Move.toml` file. You should see your package information and an `AptosFramework` dependency. The `AptosFramework` dependency points to the `aptos-core/aptos-move/framework/aptos-framework` GitHub repo main branch. ### Why `sources` directory? The `sources` directory holds a collection of `.move` modules files. And later when we want to compile the package using the CLI, the compiler will look for that `sources` directory and its `Move.toml` file. ### What is the `tests` directory? The `tests` directory holds `.move` files that are used to test the files in our `sources` directory. ### Create a Move module An account is needed to publish a Move module. When we installed the template, the tool created a new account for us and added it to the `.env` file. If you open that file, you will see content resembling: ```shellscript filename=".env" PROJECT_NAME=my-aptos-dapp VITE_APP_NETWORK=devnet VITE_APTOS_API_KEY="" VITE_MODULE_PUBLISHER_ACCOUNT_ADDRESS=0x1cecfef9e239eff12fb1a3d189a121c37f48908d86c0e9c02ec103e0a05ddebb #This is the module publisher account's private key. Be cautious about who you share it with, and ensure it is not exposed when deploying your dApp. VITE_MODULE_PUBLISHER_ACCOUNT_PRIVATE_KEY=0x84638fd5c42d0937503111a587307169842f355ab661b5253c01cfe389373f43 ``` The Boilerplate template comes with a pre generated `message_board.move` file, a relevant test file and a `Move.toml` file. As mentioned, our sources directory holds our `.move` module files; so let's create a new `todolist.move` file. 1. Create a new `todolist.move` file within the `sources` directory and add the following to that file: ```move filename="todolist.move" module todolist_addr::todolist { } ``` 2. Open the `Move.toml` file. 3. Add the following code to that Move file: ```toml filename="Move.toml" [addresses] todolist_addr='_' ``` ### What is the `'_'` in the `Move.toml` file? The `'_'` is a placeholder for the account address. When we run the `move` compiler, the compiler will replace it with the actual account address. `create-aptos-dapp` comes with premade scripts to easily run `move` commands, like `compile`, `test` and `publish`. 1. Open each of the files in the `scripts/move` directory and update the `message_board_addr` variable to be `todolist_addr`. ```js filename="scripts/move/compile.js" ... namedAddresses: { todolist_addr: process.env.VITE_MODULE_PUBLISHER_ACCOUNT_ADDRESS, }, ... ``` ### Our contract logic Before jumping into writing code, let’s first understand what we want our smart contract program to do. For ease of understanding, we will keep the logic pretty simple: 1. An account creates a new list. 2. An account creates a new task on their list. - Whenever someone creates a new task, emit a `task_created` event. 3. Let an account mark their task as completed. We can start with defining a `TodoList` struct, that holds the: - tasks array - new task event - a task counter that counts the number of created tasks (we can use that to differentiate between the tasks) And also create a `Task` struct that holds: - the task ID - derived from the TodoList task counter. - address - the account address who created that task. - content - the task content. - completed - a boolean that marks whether that task is completed or not. On the `todolist.move` file, update the content in the module with: ```move filename="todolist.move" ... struct TodoList has key { tasks: Table
My app goes here
{!accountHasList && (
)}
);
```
We now have an **Add new list** button that appears only if the account doesn’t have a list.
Start the local server with `npm run dev`. You should see the **Add new list** button.
Next, let’s understand how to create a new list by [submitting data to chain](/build/guides/build-e2e-dapp/4-submit-data-to-chain) in chapter 4.
# 4. Submit Data to Chain
> Implement transaction submission to create new todo lists using wallet adapter's signAndSubmitTransaction function.
In the fourth chapter of the tutorial on [building an end-to-end dapp on Aptos](/build/guides/build-e2e-dapp), you will be submitting data to the chain.
So now we have an **Add new list** button that appears if the connected account hasn’t created a list yet. We still don't have a way for an account to create a list, so let’s add that functionality.
1. First, our wallet adapter provider has a `signAndSubmitTransaction` function; let’s extract it by updating the following:
```tsx filename="App.tsx"
const { account, signAndSubmitTransaction } = useWallet();
```
2. Add an `onClick` event to the new list button:
```tsx filename="App.tsx"
```
3. Update the import statement from `@aptos-labs/wallet-adapter-react` to also import the `InputTransactionData` type and
```tsx filename="App.tsx"
import {
useWallet,
InputTransactionData,
} from "@aptos-labs/wallet-adapter-react";
```
4. Add the `addNewList` function:
```tsx filename="App.tsx"
const addNewList = async () => {
if (!account) return [];
const transaction:InputTransactionData = {
data: {
function:`${moduleAddress}::todolist::create_list`,
functionArguments:[]
}
}
try {
// sign and submit transaction to chain
const response = await signAndSubmitTransaction(transaction);
// wait for transaction
await aptosClient().waitForTransaction({transactionHash:response.hash});
setAccountHasList(true);
} catch (error: any) {
setAccountHasList(false);
}
};
```
5. Since our new function also uses `moduleAddress`, let’s get it out of the `fetchList` function scope to the global scope so it can be used globally.
In our `fetchList` function, find the line:
```tsx filename="App.tsx"
const moduleAddress = MODULE_ADDRESS;
```
And move it to outside of the main `App` function, so it can be globally accessed.
**Let’s go over the `addNewList` function code.**
First, we use the `account` property from our wallet provider to make sure there is an account connected to our app.
Then we build our transaction data to be submitted to chain:
```tsx filename="App.tsx"
const transaction:InputTransactionData = {
data: {
function:`${moduleAddress}::todolist::create_list`,
functionArguments:[]
}
}
```
- `function`- is built from the module address, module name and the function name.
- `functionArguments` - the arguments the function expects, in our case it doesn’t expect any arguments.
Next, we submit the transaction payload and wait for its response. The response returned from the `signAndSubmitTransaction` function holds the transaction hash. Since it can take a bit for the transaction to be fully executed on chain and we also want to make sure it is executed successfully, we `waitForTransaction`. And only then we can set our local `accountHasList` state to `true`.
6. Before testing our app, let’s tweak our UI a bit and add a Spinner component to show up while we are waiting for the transaction.
Add a local state to keep track whether a transaction is in progress:
```tsx filename="App.tsx"
const [transactionInProgress, setTransactionInProgress] =
useState
{tasks &&
tasks.length > 0 &&
tasks.map((task) => (
))}
)}
```
That will display the **Add new list** button if account doesn’t have a list or instead the tasks if the account has a list.
Go ahead and refresh your browser - see the magic!
We haven’t added any tasks yet, so we dont see anything. Let’s add the option to add some tasks!
## Add task
1. Update our UI with an _add task_ input:
```tsx filename="App.tsx"
{!accountHasList ? (
...
) : (
{task.content}
// Add this!
...
...
)}
```
We have added a text input to write the task and a button to add the task.
2. Create a new local state that holds the task content:
```tsx filename="App.tsx"
function App() {
...
const [newTask, setNewTask] = useStateTransaction Details
```json { "version": "1747361321", "hash": "0x7c56ad56c7d02bb11887e535b9f1b221626d5b0d4cb5a1ffbadc358c1db515ea", "state_change_hash": "0xc901b5e9e0965201e8205977720d7dea8a3709ee0d818fd5ec752cac13eaf18a", "event_root_hash": "0x0077cb7df9db9ee7194c489db177fe9a325bcf3f1309ea99ed934085e5592041", "state_checkpoint_hash": null, "gas_used": "999", "success": true, "vm_status": "Executed successfully", "accumulator_root_hash": "0xb531e918441ff0a37b49856e0f1b80c329146461582287cf9788964d25e31a68", } ```Coin Store Changes
```json "changes": [ { "address": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "state_key_hash": "0xb2bfa7198457291a0e582b912be2bf8577feff08e352c9f16935a55ebd202dcc", "data": { "type": "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>", "data": { "coin": { "value": "903837250" }, "deposit_events": { "counter": "10", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "2" } } }, "frozen": false, "withdraw_events": { "counter": "52485", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "3" } } } } }, "type": "write_resource" }, { "address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "state_key_hash": "0xa45b7cfe18cc0ef1d6588f0f548a6a6a260d5e6bbab174507ed40cd21b7bd082", "data": { "type": "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>", "data": { "coin": { "value": "10" }, "deposit_events": { "counter": "1", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "2" } } }, "frozen": false, "withdraw_events": { "counter": "0", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "3" } } } } }, "type": "write_resource" }], ```Coin Withdraw Event
```json { "events": [ { "guid": { "creation_number": "3", "account_address": "0xf8e25f6c8ce40a15107fb4b4d288ca03dd434d057392f2ccb5fde505a300a0bf" }, "sequence_number": "0", "type": "0x1::coin::WithdrawEvent", "data": { "amount": "100000" } }, ] } ```Coin Store Deletion Event
```json { "events": [ { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::coin::CoinStoreDeletion", "data": { "coin_type": "0x1::aptos_coin::AptosCoin", "deleted_deposit_event_handle_creation_number": "2", "deleted_withdraw_event_handle_creation_number": "3", "event_handle_creation_address": "0xf8e25f6c8ce40a15107fb4b4d288ca03dd434d057392f2ccb5fde505a300a0bf" } } ] } ```Coin Deposit Event
```json { "events": [{ "guid": { "creation_number": "2", "account_address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28" }, "sequence_number": "0", "type": "0x1::coin::DepositEvent", "data": { "amount": "10" } }] } ```Gas Information
```json { "gas_used": "999", "max_gas_amount": "100000", "gas_unit_price": "100", "sender": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", } ```Full Response
```json { "version": "1747361321", "hash": "0x7c56ad56c7d02bb11887e535b9f1b221626d5b0d4cb5a1ffbadc358c1db515ea", "state_change_hash": "0xc901b5e9e0965201e8205977720d7dea8a3709ee0d818fd5ec752cac13eaf18a", "event_root_hash": "0x0077cb7df9db9ee7194c489db177fe9a325bcf3f1309ea99ed934085e5592041", "state_checkpoint_hash": null, "gas_used": "999", "success": true, "vm_status": "Executed successfully", "accumulator_root_hash": "0xb531e918441ff0a37b49856e0f1b80c329146461582287cf9788964d25e31a68", "changes": [ { "address": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "state_key_hash": "0xb2bfa7198457291a0e582b912be2bf8577feff08e352c9f16935a55ebd202dcc", "data": { "type": "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>", "data": { "coin": { "value": "903837250" }, "deposit_events": { "counter": "10", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "2" } } }, "frozen": false, "withdraw_events": { "counter": "52485", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "3" } } } } }, "type": "write_resource" }, { "address": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "state_key_hash": "0xa3f2635d084b3cc01ae545c96ee15901549dab594363a46bf18e3d575c83102d", "data": { "type": "0x1::account::Account", "data": { "authentication_key": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "coin_register_events": { "counter": "1", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "0" } } }, "guid_creation_num": "4", "key_rotation_events": { "counter": "0", "guid": { "id": { "addr": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "creation_num": "1" } } }, "rotation_capability_offer": { "for": { "vec": [] } }, "sequence_number": "104628", "signer_capability_offer": { "for": { "vec": [] } } } }, "type": "write_resource" }, { "address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "state_key_hash": "0xa45b7cfe18cc0ef1d6588f0f548a6a6a260d5e6bbab174507ed40cd21b7bd082", "data": { "type": "0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>", "data": { "coin": { "value": "10" }, "deposit_events": { "counter": "1", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "2" } } }, "frozen": false, "withdraw_events": { "counter": "0", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "3" } } } } }, "type": "write_resource" }, { "address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "state_key_hash": "0xba04f5a13812778031f67322e9801be65a846224e46f1360a6008402fcd0e0e0", "data": { "type": "0x1::account::Account", "data": { "authentication_key": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "coin_register_events": { "counter": "1", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "0" } } }, "guid_creation_num": "4", "key_rotation_events": { "counter": "0", "guid": { "id": { "addr": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "creation_num": "1" } } }, "rotation_capability_offer": { "for": { "vec": [] } }, "sequence_number": "0", "signer_capability_offer": { "for": { "vec": [] } } } }, "type": "write_resource" }, { "state_key_hash": "0x6e4b28d40f98a106a65163530924c0dcb40c1349d3aa915d108b4d6cfc1ddb19", "handle": "0x1b854694ae746cdbd8d44186ca4929b2b337df21d1c74633be19b2710552fdca", "key": "0x0619dc29a0aac8fa146714058e8dd6d2d0f3bdf5f6331907bf91f3acd81e6935", "value": "0x9f9835f429758d010000000000000000", "data": null, "type": "write_table_item" } ], "sender": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0", "sequence_number": "104627", "max_gas_amount": "100000", "gas_unit_price": "100", "expiration_timestamp_secs": "1727826277", "payload": { "function": "0x1::aptos_account::transfer", "type_arguments": [], "arguments": [ "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28", "10" ], "type": "entry_function_payload" }, "signature": { "public_key": "0xfd448fada2bac29c5f3213277e001ca8851d5644578e79484b0426c41357a457", "signature": "0x40d8a6ee9150aa5736bee23ce1b1b851790bc0aa7e2485c0760d5808027040a2ef4170b88962867b045197576c5e89a4c640bf43586e6b3ead2b510b59acc20a", "type": "ed25519_signature" }, "events": [ { "guid": { "creation_number": "0", "account_address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28" }, "sequence_number": "0", "type": "0x1::account::CoinRegisterEvent", "data": { "type_info": { "account_address": "0x1", "module_name": "0x6170746f735f636f696e", "struct_name": "0x4170746f73436f696e" } } }, { "guid": { "creation_number": "3", "account_address": "0x559d4f690c683fca7c539237aa8dc4c6ec09886b7016bf66f2cdeffef55468f0" }, "sequence_number": "52484", "type": "0x1::coin::WithdrawEvent", "data": { "amount": "10" } }, { "guid": { "creation_number": "2", "account_address": "0x5d6233bb8d7f8bd714af196339e9fb3104c9d66f38867b2a0585c4f7b9d04d28" }, "sequence_number": "0", "type": "0x1::coin::DepositEvent", "data": { "amount": "10" } }, { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::transaction_fee::FeeStatement", "data": { "execution_gas_units": "6", "io_gas_units": "5", "storage_fee_octas": "98800", "storage_fee_refund_octas": "0", "total_charge_gas_units": "999" } } ], "timestamp": "1727825677775812", "type": "user_transaction" } ```Fungible Asset Events
```json { "events": [ { "type": "0x1::fungible_asset::Withdraw", "data": { "amount": "1", "store": "0x8a9d57692a9d4deb1680eaf107b83c152436e10f7bb521143fa403fa95ef76a" } }, { "type": "0x1::fungible_asset::Deposit", "data": { "amount": "1", "store": "0x8a9d57692a9d4deb1680eaf107b83c152436e10f7bb521143fa403fa95ef76a" } } ] } ```Fungible Asset Changes
```json { "changes":[ { "address": "0x8a9d57692a9d4deb1680eaf107b83c152436e10f7bb521143fa403fa95ef76a", "state_key_hash": "0x5b587931247dd5b43874ab29c3305c0ee7d26e7571fed3aea409375530e3a62c", "data": { "type": "0x1::fungible_asset::FungibleStore", "data": { "balance": "126691270443", "frozen": false, "metadata": { "inner": "0x2ebb2ccac5e027a87fa0e2e5f656a3a4238d6a48d93ec9b610d570fc0aa0df12" } } }, "type": "write_resource" }, { "address": "0x8a9d57692a9d4deb1680eaf107b83c152436e10f7bb521143fa403fa95ef76a", "state_key_hash": "0x5b587931247dd5b43874ab29c3305c0ee7d26e7571fed3aea409375530e3a62c", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": false, "guid_creation_num": "1125899906842628", "owner": "0xc67545d6f3d36ed01efc9b28cbfd0c1ae326d5d262dd077a29539bcee0edce9e", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0x8a9d57692a9d4deb1680eaf107b83c152436e10f7bb521143fa403fa95ef76a", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" } ] } ```FungibleStore Deletion Event
```json { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::fungible_asset::FungibleStoreDeletion", "data": { "metadata": "0x2ebb2ccac5e027a87fa0e2e5f656a3a4238d6a48d93ec9b610d570fc0aa0df12", "owner": "0xcf3906e2c9bc7e489c3b09d5ed5d90d8d403a68a50fe52932116b26e5878af26", "store": "0xa6ab8518e5f28a5f27247a895aa8b3de4a917209c6841b16187e8d64a67de242" } } ```Full response
```json { "version": "1642580695", "hash": "0xe67ba1c4242d5c1de42eb8419558c4edf2318e185a3940a00f4150b519d06508", "state_change_hash": "0x07c5ec97afdf731c2778fccb37fe209369b28dcf6dcf11c3cf13b83c962f7f96", "event_root_hash": "0xad349cbea90bef601dfae9df822f5698af296951fc5f94359fcacc1e69e9fa3d", "state_checkpoint_hash": null, "gas_used": "545", "success": true, "vm_status": "Executed successfully", "accumulator_root_hash": "0x88e81bde70f32a86e46b288a917a44b2868a46973fac7fad16b5e780f48b0e67", "changes": [ { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::coin::PairedCoinType", "data": { "type": { "account_address": "0x1", "module_name": "0x6170746f735f636f696e", "struct_name": "0x4170746f73436f696e" } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::coin::PairedFungibleAssetRefs", "data": { "burn_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] }, "mint_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] }, "transfer_ref_opt": { "vec": [ { "metadata": { "inner": "0xa" } } ] } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::fungible_asset::ConcurrentSupply", "data": { "current": { "max_value": "340282366920938463463374607431768211455", "value": "47948384" } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::fungible_asset::Metadata", "data": { "decimals": 8, "icon_uri": "", "name": "Aptos Coin", "project_uri": "", "symbol": "APT" } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": true, "guid_creation_num": "1125899906842625", "owner": "0x1", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0xa", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" }, { "address": "0xa", "state_key_hash": "0x1db5441d8fa4229c5844f73fd66da4ad8176cb8793d8b3a7f6ca858722030043", "data": { "type": "0x1::primary_fungible_store::DeriveRefPod", "data": { "metadata_derive_ref": { "self": "0xa" } } }, "type": "write_resource" }, { "address": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188", "state_key_hash": "0x5ce89e323a23fb5570694dfb687d474d44563638c5ef774a2364d8347f5732b8", "data": { "type": "0x1::coin::MigrationFlag", "data": { "dummy_field": false } }, "type": "write_resource" }, { "address": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188", "state_key_hash": "0x5ce89e323a23fb5570694dfb687d474d44563638c5ef774a2364d8347f5732b8", "data": { "type": "0x1::fungible_asset::FungibleStore", "data": { "balance": "37949184", "frozen": false, "metadata": { "inner": "0xa" } } }, "type": "write_resource" }, { "address": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188", "state_key_hash": "0x5ce89e323a23fb5570694dfb687d474d44563638c5ef774a2364d8347f5732b8", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": false, "guid_creation_num": "1125899906842625", "owner": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" }, { "address": "0x8a4613c356c21a45045e06dcc404bfee363aabd65a774d4d43defd71289239b2", "state_key_hash": "0x7c2d6e31d4ac5bbf93e19412437c0c288766b240674f71f457b9e3ef68be5003", "data": { "type": "0x1::fungible_asset::FungibleStore", "data": { "balance": "10000", "frozen": false, "metadata": { "inner": "0xa" } } }, "type": "write_resource" }, { "address": "0x8a4613c356c21a45045e06dcc404bfee363aabd65a774d4d43defd71289239b2", "state_key_hash": "0x7c2d6e31d4ac5bbf93e19412437c0c288766b240674f71f457b9e3ef68be5003", "data": { "type": "0x1::object::ObjectCore", "data": { "allow_ungated_transfer": false, "guid_creation_num": "1125899906842625", "owner": "0x5", "transfer_events": { "counter": "0", "guid": { "id": { "addr": "0x8a4613c356c21a45045e06dcc404bfee363aabd65a774d4d43defd71289239b2", "creation_num": "1125899906842624" } } } } }, "type": "write_resource" }, { "address": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "state_key_hash": "0xfb7c1f2762da89f00a222f93bd771b478edb4361475c4a518178564be8616dd6", "data": { "type": "0x1::account::Account", "data": { "authentication_key": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "coin_register_events": { "counter": "14", "guid": { "id": { "addr": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "creation_num": "0" } } }, "guid_creation_num": "44", "key_rotation_events": { "counter": "0", "guid": { "id": { "addr": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "creation_num": "1" } } }, "rotation_capability_offer": { "for": { "vec": [] } }, "sequence_number": "52", "signer_capability_offer": { "for": { "vec": [] } } } }, "type": "write_resource" } ], "sender": "0xa746e980ae21949a4f084db7403430f00bce3c9a1da4101ffcf0bf45ebd35e7e", "sequence_number": "51", "max_gas_amount": "817", "gas_unit_price": "100", "expiration_timestamp_secs": "1724196316", "payload": { "function": "0x1::primary_fungible_store::transfer", "type_arguments": [ "0x1::fungible_asset::Metadata" ], "arguments": [ { "inner": "0xa" }, "0x5", "10000" ], "type": "entry_function_payload" }, "signature": { "public_key": "0x330e75a102e37270b788caee8dd819e5badedd5fa17fe9f72017732e9bb98c60", "signature": "0xd4666df2887cf2d8192230e4a03d842ea75a86ffbc46a9a16a9baede6ff646c6b2bcafc524d3a4a7a66c223b5db576beb5cfefbd549620e69097c0a364c7a800", "type": "ed25519_signature" }, "events": [ { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::fungible_asset::Withdraw", "data": { "amount": "10000", "store": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188" } }, { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::fungible_asset::Deposit", "data": { "amount": "10000", "store": "0x8a4613c356c21a45045e06dcc404bfee363aabd65a774d4d43defd71289239b2" } }, { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::fungible_asset::Withdraw", "data": { "amount": "54500", "store": "0x7ed92ce166e251fc133f6b4d46a6b41307962e3b6864c2231110b3808648188" } }, { "guid": { "creation_number": "0", "account_address": "0x0" }, "sequence_number": "0", "type": "0x1::transaction_fee::FeeStatement", "data": { "execution_gas_units": "6", "io_gas_units": "7", "storage_fee_octas": "53240", "storage_fee_refund_octas": "0", "total_charge_gas_units": "545" } } ], "timestamp": "1724196287102837", "type": "user_transaction" } ```Example output
```shellscript filename="Terminal" { "Result": { "Account Address:": "0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b", "PublicKey Path": "private-key-a.pub", "PrivateKey Path": "private-key-a" } } ```Example output
```shellscript filename="Terminal" { "Error": "API error: API error Error(AccountNotFound): Account not found by Address(0xaaafb224eb00e4d0ef520ce02038ede850893622562a4189b7f6e5d94454ccd9) and Ledger version(1206)" } ```Example output
```shellscript filename="Terminal" Configuring for profile test-profile-1 Configuring for network Local Using command line argument for private key Account 0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b doesn\'t exist, creating it and funding it with 100000000 Octas Account 0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b funded successfully --- Aptos CLI is now set up for account 0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b as profile test-profile-1! Run `aptos --help` for more information about commands { "Result": "Success" } ```Example output
```shellscript filename="Terminal" { "Result": { "test-profile-1": { "has_private_key": true, "public_key": "0xe0bfe46f41c5be40e7a068e8dff4d6016126b226d947a39262f5b2347217a7e3", "account": "aaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } ```Example output
```shellscript filename="Terminal" { "Result": "0xcc3b0c38ad99e171263a7af930464313d1fb105d0d8e6a4b13f9b1140563a7dd" } ```Example output
```shellscript filename="Terminal" { "Result": "aaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b" } ```Example output
```shellscript filename="Terminal" { "Result": [ "0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b" ] } ```Example output
```shellscript filename="Terminal" { "Result": [ { "vec": [] } ] } ```Example output
```shellscript filename="Terminal" { "Result": { "transaction_hash": "0x216992ef37a3c2f42aa9f8fed8f94d9f945a00e952dfe96b46123bb5c387ab6c", "gas_used": 444, "gas_unit_price": 100, "sender": "aaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b", "sequence_number": 0, "success": true, "timestamp_us": 1717809169531279, "version": 3268, "vm_status": "Executed successfully" } } ```Example output
```shellscript filename="Terminal" { "Result": [ { "vec": [ "0xaaa5131b4d3fcef8d33ee465c4ee65727e36039f283455be87b1164200572e5b" ] } ] } ```Example output
```shellscript filename="Terminal" { "Result": { "PrivateKey Path": "private-key-b", "Account Address:": "0xbbbdb12f4fa23b8fe8711b77f4ab7108f3a22077c5dfe787eed3d048a0b82734", "PublicKey Path": "private-key-b.pub" } } ```Example output
```shellscript filename="Terminal" { "Result": { "message": "Saved new profile test-profile-2", "transaction": { "transaction_hash": "0xe561b710390511203511d15eee6f019a2e43ba32f8e3b7ce6bf812232e3bd27f", "gas_used": 449, "gas_unit_price": 100, "sender": "aaa8dc0f5e7a6e820f7b1906d99864412b12274ed259ad06bc2c2d8ee7b51e51", "sequence_number": 1, "success": true, "timestamp_us": 1717810059696079, "version": 1109, "vm_status": "Executed successfully" } } } ```Example output
```shellscript filename="Terminal" { "Result": { "test-profile-1": { "has_private_key": true, "public_key": "0xb517173e68f4116e99c7fa1677058a6ee786a3b9e12447000db7fd85ab99dbdd", "account": "aaa8dc0f5e7a6e820f7b1906d99864412b12274ed259ad06bc2c2d8ee7b51e51", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } { "Result": { "test-profile-2": { "has_private_key": true, "public_key": "0xadc3dd795fdd8569f59dc7b9900b38a5d7b95348b815de4eb5f00e2c2da07916", "account": "aaa8dc0f5e7a6e820f7b1906d99864412b12274ed259ad06bc2c2d8ee7b51e51", "rest_url": "http://localhost:8080", "faucet_url": "http://localhost:8081" } } } ```Example output
```shellscript filename="Terminal" { "Result": [ "0xbbbdb12f4fa23b8fe8711b77f4ab7108f3a22077c5dfe787eed3d048a0b82734" ] } ```Example output
```shellscript filename="Terminal" { "Result": [ { "vec": [ "0xaaa8dc0f5e7a6e820f7b1906d99864412b12274ed259ad06bc2c2d8ee7b51e51" ] } ] } ```Example output
```shellscript filename="Terminal" { "Result": [ { "vec": [] } ] } ```Example output
```shellscript filename="Terminal" { "Error": "Invalid arguments: New public key cannot be the same as the current public key" } ```Example output
```shellscript filename="Terminal" { "Result": { "PrivateKey Path": "private-key-c", "PublicKey Path": "private-key-c.pub", "Account Address:": "0xccc79d46b2963cb87f2ff32c51eb6c6361e8aa108d334d3183c3016389542958" } } ```Example output
```shellscript filename="Terminal" Configuring for profile test-profile-3 Configuring for network Local Using command line argument for private key Account 0xccc79d46b2963cb87f2ff32c51eb6c6361e8aa108d334d3183c3016389542958 doesn\'t exist, creating it and funding it with 100000000 Octas Account 0xccc79d46b2963cb87f2ff32c51eb6c6361e8aa108d334d3183c3016389542958 funded successfully --- Aptos CLI is now set up for account 0xccc79d46b2963cb87f2ff32c51eb6c6361e8aa108d334d3183c3016389542958 as profile test-profile-3! Run `aptos --help` for more information about commands { "Result": "Success" } ```Example output
```shellscript filename="Terminal" { "Error": "API error: Unknown error Transaction committed on chain, but failed execution: Move abort in 0x1::account: ENEW_AUTH_KEY_ALREADY_MAPPED(0x10015): The new authentication key already has an entry in the `OriginatingAddress` table" } ```Example output
```shellscript filename="Terminal" { "Result": { "message": "Saved new profile test-profile-4", "transaction": { "transaction_hash": "0xa5dec792d82ef7471cdf82b9c957fc79b5815da770ad1dd9232ae4692e4f0895", "gas_used": 449, "gas_unit_price": 100, "sender": "aaa8dc0f5e7a6e820f7b1906d99864412b12274ed259ad06bc2c2d8ee7b51e51", "sequence_number": 2, "success": true, "timestamp_us": 1717812312772580, "version": 5355, "vm_status": "Executed successfully" } } } ```Example output
```shellscript filename="Terminal" { "Error": "API error: Unknown error Transaction committed on chain, but failed execution: Move abort in 0x1::account: EINVALID_ORIGINATING_ADDRESS(0x6000d): Abort the transaction if the expected originating address is different from the originating address on-chain" } ```# Getting Recent Transactions A helpful variant of the above query limits results to just ones that happened after a specific `transaction_version`. All results will have a `transaction_version` greater than `$gt`.
# Indexer Table Reference ## Filtering (with `where` clauses) To ensure your queries filter data efficiently, check out the available indexes for each table. Some indexes are composite B-tree indexes, meaning they consist of multiple columns. B-tree indexes are ordered and perform optimally when queries utilize a left-most prefix of the indexed columns. {/* Indexed columns are generated from https://docs.google.com/spreadsheets/d/1sQnMimoJnP5sVaLCCRK4H6AHXGCwsehAuBF9AD_0IyY/edit?gid=47194642#gid=47194642 */} ## General ### `user_transactions` Transactions filtered to user\_transactions (not system). | Index Name | Indexed Columns | | -------------------------------------------- | ----------------------- | | user\_transactions\_pkey | version | | user\_transactions\_sender\_sequence\_number\_key | sender, sequence\_number | | ut\_epoch\_index | epoch | | ut\_insat\_index | inserted\_at | | ut\_sender\_seq\_index | sender, sequence\_number | ### `block_metadata_transactions` A type of system transaction emitted once per block, useful for mapping to timestamp or epoch. | Index Name | Indexed Columns | | -------------------------------------------- | --------------- | | block\_metadata\_transactions\_block\_height\_key | block\_height | | block\_metadata\_transactions\_pkey | version | | bmt\_insat\_index | inserted\_at | ### `account_transactions` _Has an aggregate view for summary data called `account_transactions_aggregate`_ | Index Name | Indexed Columns | | ------------------------- | ------------------------------------ | | account\_transactions\_pkey | account\_address, transaction\_version | | at\_insat\_index | inserted\_at | | at\_version\_index | transaction\_version DESC | This table maps accounts and transactions that interact with that account. | Field | Type | Primary Key | Description | | ----------------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | delegated\_staking\_activities | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | fungible\_asset\_activities | Join | | References [fungible\_asset\_activities](#fungible_asset_activities). | | token\_activities | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | token\_activities\_aggregate | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | token\_activities\_v2 | Join | | References [token\_activities\_v2](#token_activities_v2). | | token\_activities\_v2\_aggregate | Join | | References [token\_activities\_v2](#token_activities_v2). | | account\_address | String! | Yes | This is an Aptos account address. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | transaction\_version | bigint! | Yes | Blockchain version of the transaction. Ex. 10000000 | ### `ledger_infos` This table shares what chain is currently being queried. | Field | Type | Primary Key | Description | | -------- | ---- | ----------- | ------------------------------------------------------------------------------------------------- | | chain\_id | int | Yes | The unique identifier for the chain you are accessing. Ex. 1 (for Mainnet), 2 (for Testnet), etc. | ### `processor_status` This table shares how current this processor's data is. gives you latest version processed per “processor” | Field | Type | Primary Key | Description | | -------------------------- | ------ | ----------- | ------------------------------------------------------------------------------------------------------- | | last\_success\_version | bigint | Yes | The version number of the last successful processor run. Ex. 5000000 | | last\_transaction\_timestamp | String | | Timestamp of the last processed transaction. Ex. "2024-04-17T02:14:25.68771" | | last\_updated | String | | Timestamp of the last update to this processor's status. Ex. "2024-04-17T02:14:25.68771" | | processor | String | Yes | Name of the processor. Ex. "transaction\_processor" | ## NFT ### `token_activities_v2` _Has an aggregate view for summary data called `token_activities_v2_aggregate`_ | Index Name | Indexed Columns | | ------------------------ | -------------------------------- | | ta2\_from\_type\_index | from\_address, type | | ta2\_insat\_index | inserted\_at | | ta2\_owner\_type\_index | event\_account\_address, type | | ta2\_tid\_index | token\_data\_id | | ta2\_to\_type\_index | to\_address, type | | token\_activities\_v2\_pkey | transaction\_version, event\_index | This table tracks token activities and is especially useful for tracking NFT activity. This includes both v1 and v2 data. | Field | Type | Primary Key | Description | | -------------------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | aptos\_names\_from | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | aptos\_names\_from\_aggregate | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | aptos\_names\_to | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | aptos\_names\_to\_aggregate | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | current\_token\_data | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | after\_value | String | | The value of a token property after the transaction. Ex. "100" | | before\_value | String | | The value of a token property before the transaction. Ex. "50" | | entry\_function\_id\_str | String | | The identifier of the function called in this transaction. Ex. "0x1::aptos\_account::transfer" | | event\_account\_address | String | | This is an Aptos account address related to the event. This address must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | event\_index | bigint | Yes | Index of the event within the transaction. Ex. 1 | | from\_address | String | | This is an Aptos account address from which the token was sent. This address must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | is\_fungible\_v2 | Boolean | | Indicates whether the token is fungible. Soon to be deprecated. Ex. False for NFTs. | | property\_version\_v1 | bigint | | The version of the token's properties under schema version 1. This field is only for token standard v1. It is always 0 for v2. Ex. 0 | | to\_address | String | | This is an Aptos account address to which the token was sent. This address must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | token\_amount | bigint | | The amount of the token transferred in this activity. Ex. 3 | | token\_data\_id | String | | Unique identifier for this particular token's data. For token standard v1, this is derived from a combination of creator\_address, collection\_name, and token\_name. This ID must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | | transaction\_timestamp | String | | Timestamp when the transaction occurred. Ex. "2024-04-17T02:14:25.68771" | | transaction\_version | bigint | Yes | Blockchain version of the transaction. Ex. 10000000 | | type | String | | Type of transfer - like "deposit" or "withdrawal". Ex. "0x3::token::DepositEvent" | ### `nft_metadata_crawler_parsed_asset_uris` This table allows you to look up the cdn and uris for NFT images / content. | Field | Type | Primary Key | Description | | ------------------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------- | | animation\_optimizer\_retry\_count | Int | | Number of retries to optimize animation. Ex. 3 | | asset\_uri | String | Yes | URI of the asset. Ex. "https://example.com/nft/123" | | cdn\_animation\_uri | String | | Content Delivery Network URI for animation. Ex. "https://cdn.example.com/animations/123" | | cdn\_image\_uri | String | | Content Delivery Network URI for image. Ex. "https://cdn.example.com/images/123" | | cdn\_json\_uri | String | | Content Delivery Network URI for JSON metadata. Ex. "https://cdn.example.com/metadata/123.json" | | raw\_animation\_uri | String | | Original URI for animation before CDN optimization. Ex. "https://example.com/raw/animations/123" | | raw\_image\_uri | String | | Original URI for image before CDN optimization. Ex. "https://example.com/raw/images/123" | | Index Name | Indexed Columns | | ---------------------- | ----------------- | | nft\_inserted\_at | inserted\_at | | nft\_raw\_animation\_uri | raw\_animation\_uri | | nft\_raw\_image\_uri | raw\_image\_uri | | parsed\_asset\_uris\_pkey | asset\_uri | ### `current_token_ownerships_v2` _Has an aggregate view for summary data called `current_token_ownerships_v2_aggregate`_ This table tracks who owns which NFTs. This includes both v1 and v2 tokens. Fungible tokens are not tracked as consistently. | Field | Type | Primary Key | Description | | --------------------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | composed\_nfts\_aggregate | Join | | Aggregate information about the composed NFTs, such as count or other statistics. | | current\_token\_data | Join | | Detailed information about the token's current data; structure is defined in a related table. | | amount | bigint | | The amount of the token owned. Example: 1 for an NFT. | | composed\_nfts | Array | | An array containing the IDs of NFTs that compose this token, if applicable. | | is\_fungible\_v2 | Boolean | | Indicates whether the token is fungible. Example: true or null | | is\_soulbound\_v2 | Boolean | | Indicates whether the token is soulbound (non-transferable once owned). Example: true or null | | last\_transaction\_timestamp | String | | Timestamp of the last transaction involving the token. Example: "2024-04-17T02:14:25.68771" | | last\_transaction\_version | bigint | | The version number of the last transaction involving the token. Example: 20747031 | | non\_transferrable\_by\_owner | Boolean | | Indicates whether the token is non-transferrable by the owner. Example: true or null | | owner\_address | String | Yes | The Aptos account address that currently owns the token. Addresses must be 66 characters so may be 0 padded. Example: "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | property\_version\_v1 | bigint | Yes | The version number of the token's properties as of the last update. This field is only for token standard v1. It is always 0 for v2. Example: 0 | | storage\_id | String | Yes | A unique identifier used for storage purposes. IDs must be 66 characters long, so may be 0 padded. Ex. "0xd8d41ff9f67d17d7dee061b5b683b92013b420cb6a30c21fc7c287454792d7a8" | | table\_type\_v1 | String | | The Move function type. Example: "0x3::token::TokenStore" | | token\_data\_id | String | Yes | A unique identifier for the token data, typically a hash or a numeric ID. Ex. "0x3d911af2dc3e47848fbba17b8694cf526942be183b84f8393a6c048232fb976d" | | token\_properties\_mutated\_v1 | Object | | Properties of the token that have been mutated from the original. Often in JSON or similar format. Example: { } | | token\_standard | String | | The standard used to generate this token. Ex. "v1" or "v2" | | Index Name | Indexed Columns | | -------------------------------- | ------------------------------------------------------------- | | curr\_to2\_insat\_index | inserted\_at | | curr\_to2\_owner\_index | owner\_address | | curr\_to2\_wa\_index | storage\_id | | current\_token\_ownerships\_v2\_pkey | token\_data\_id, property\_version\_v1, owner\_address, storage\_id | ### `current_token_datas_v2` This table tracks the metadata associated with each NFT (Ex. URI, supply, etc.). This tracks both v1 and v2 tokens. | Field | Type | Primary Key | Description | | ---------------------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | cdn\_asset\_uris | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | current\_collection | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | current\_token\_ownerships | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | current\_token\_ownerships\_aggregate | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | aptos\_name | String | | This is a name tied to this token using the Aptos Name Service (ANS). Ex. "EpicDragon" | | collection\_id | String | Yes | Identifier for the collection that includes this token. Ex. "0x360f6eeabb4d7a9d2fab1f35b01e02831e3b5c4b73c7fd6c98dcc1c301c817c8" | | decimals | bigint | | Number of decimal places for token value, typically for fungible tokens. Ex. 18 | | description | String | | Description of the token. Ex. "A legendary dragon from the mystical lands." | | is\_fungible\_v2 | Boolean | | Whether the token is fungible. Ex. False for NFTs | | largest\_property\_version\_v1 | bigint | | The largest version number of the token's properties under the first schema. Ex. 1 | | last\_transaction\_timestamp | bigint | | Unix timestamp of the last transaction involving this token. Ex. 2024-03-27T07:41:58.800893 | | last\_transaction\_version | bigint | | Blockchain version of the last transaction involving this token. Ex. 30000000 | | maximum | bigint | | Maximum possible quantity of this token, relevant for fungibles. Ex. 1000000 | | supply | bigint | | Current supply of the token in circulation. Ex. 500000 | | token\_data\_id | String | | Unique identifier for the token's data. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | token\_name | String | | The formal name of the token. Ex. "Mystic Dragon" | | token\_properties | Object | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | | token\_uri | String | | URI linking to further information about the token. Ex. "https://example.com/tokens/987654321" | | Index Name | Indexed Columns | | --------------------------- | ------------------------- | | cur\_td2\_cid\_name\_index | collection\_id, token\_name | | cur\_td2\_insat\_index | inserted\_at | | current\_token\_datas\_v2\_pkey | token\_data\_id | ### `current_collections_v2` This table tracks the metadata associated with each NFT collection (Ex. collection\_id, creator\_address, etc.). This tracks both v1 and v2 tokens. | Field | Type | Primary Key | Description | | -------------------------- | ------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cdn\_asset\_uris | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | collection\_id | String | Yes | Unique identifier for the collection. IDs must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b88" | | collection\_name | String | | The formal name of the collection. Ex. "Mythic Dragons" | | creator\_address | String | | This is an Aptos account address that created the collection. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | current\_supply | bigint | | Current supply of tokens in this collection. Ex. 500 | | description | String | | Description of the collection. Ex. "A collection of rare digital dragons." | | last\_transaction\_timestamp | String | | Timestamp of the last transaction involving this collection. Ex. "2024-04-17T02:14:25.68771" | | last\_transaction\_version | bigint | | Blockchain version of the last transaction involving this collection. Ex. 3000000002 | | max\_supply | bigint | | Maximum possible quantity of tokens in this collection. If the max supply is 0, there is no limit on the supply. Ex. 1000 | | mutable\_description | String | | Changeable description of the collection. Ex. "Updated collection description." | | mutable\_uri | Boolean | | True if the uri is changeable by the creator. Ex. True | | table\_handle\_v1 | String | | Legacy identifier handle for the collection in earlier schema versions. Ex. "handle\_12345" | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | | total\_minted\_v2 | bigint | | Total number of tokens minted in this collection under schema version 2. Ex. 800 | | uri | String | | This is a URI to where the image live. This can also be JSON data. Ex. "https://example.com/collections/9876543210" | | Index Name | Indexed Columns | | --------------------------- | -------------------------------- | | cur\_col2\_crea\_cn\_index | creator\_address, collection\_name | | cur\_col2\_insat\_index | inserted\_at | | current\_collections\_v2\_pkey | collection\_id | ### `current_collection_ownership_v2_view` _Has an aggregate view for summary data called `current_collection_ownership_v2_view_aggregate`_ This table maps collections to who owns them and helps count how much of a collection is owned by other accounts. | Field | Type | Primary Key | Description | | ------------------------ | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | current\_collection | Join | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see these sub-fields. | | collection\_id | String | Yes | Unique identifier for the collection. IDs must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | collection\_name | String | | The formal name of the collection. Ex. "Mythic Dragons" | | collection\_uri | String | | URI linking to further information about the collection. Ex. "https://example.com/collections/9876543210" | | creator\_address | String | | This is an Aptos account address that created the collection. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | distinct\_tokens | bigint | | The count of distinct tokens owned within this collection. Ex. 150 | | last\_transaction\_version | bigint | | The version number of the last transaction involving this collection. Ex. 3000000002 | | owner\_address | String | Yes | This is an Aptos account address that currently owns the token. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | single\_token\_uri | String | | URI linking to information about a specific token within the collection. Ex. "https://example.com/tokens/9876543210" | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | ## Fungible Assets ### `fungible_asset_metadata` This tracks the metadata tied to each fungible asset (ex. decimals of precision). It includes v1 token data. This is a current\_ table. | Field | Type | Primary Key | Description | | --------------------------------- | ------ | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | asset\_type | String | Yes | The type of the asset, described by a Move resource. Ex. "0x1::aptos\_coin::AptosCoin" | | creator\_address | String | | This is an Aptos account address that created the asset. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | decimals | bigint | | Number of decimal places for token value, typically for fungible tokens. Ex. 18 | | icon\_uri | String | | URI for the icon of the asset. Ex. "https://cdn.example.com/icons/123" | | last\_transaction\_timestamp | String | | Timestamp of the last transaction involving this asset. Ex. "2024-04-17T02:14:25.68771" | | last\_transaction\_version | bigint | | Blockchain version of the last transaction involving this asset. Ex. 10000000 | | name | String | | The formal name of the asset. Ex. "Digital Gold" | | project\_uri | String | | URI linking to the project information associated with this asset. Ex. "https://www.example.com/project\_name/" | | supply\_aggregator\_table\_handle\_v1 | String | | Legacy handle for the supply aggregator table from an earlier schema version. Ex. "handle\_67890" | | supply\_aggregator\_table\_key\_v1 | String | | Legacy key for accessing the supply aggregator table in earlier schema versions. Ex. "key\_12345" | | symbol | String | | The trading symbol of the asset. Ex. "DGOLD" | | token\_standard | String | | Standard that the asset adheres to. Ex. "v1" | | Index Name | Indexed Columns | | ---------------------------- | --------------- | | fam\_creator\_index | creator\_address | | fam\_insat\_index | inserted\_at | | fungible\_asset\_metadata\_pkey | asset\_type | ### `fungible_asset_activities` This tracks the activity of fungible assets. It includes v1 token data. | Field | Type | Primary Key | Description | | --------------------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | owner\_aptos\_names | Join | | References [owner\_aptos\_names](#current_aptos_names). | | owner\_aptos\_names\_aggregate | Join | | References [owner\_aptos\_names](#current_aptos_names). | | amount | bigint | | The amount of the asset involved in the activity. Ex. 1000 | | asset\_type | String | Yes | The type of the asset, described by a Move resource. For fungible assets, this will be the address of the metadata object. Ex. "0x1::aptos\_coin::AptosCoin" | | block\_height | bigint | | The blockchain id at which this activity occurred. Ex. 1500000 | | entry\_function\_id\_str | String | | The identifier of the function called in this transaction. Ex. "0x1::aptos\_account::transfer" | | event\_index | bigint | | Index of the event within the transaction. Ex. 1 | | gas\_fee\_payer\_address | String | | This is an Aptos account address that paid the gas fee for the transaction. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | is\_frozen | Boolean | | True if this activity is a freeze asset activity. Ex. null | | is\_gas\_fee | Boolean | | Indicates whether this activity involved a gas fee. Ex. True | | is\_transaction\_success | Boolean | | Indicates whether the transaction was successful. Ex. True | | metadata | Object | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see fields for `metadata` in this table. | | owner\_address | String | | This is an Aptos account address that owns the asset. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | storage\_id | String | | Identifier for the storage used in the transaction. IDs must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | storage\_refund\_amount | bigint | | Amount refunded for storage after the transaction. This is always in APT [octas](/network/glossary#Octa). Ex. 50 | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | | transaction\_timestamp | String | | Timestamp when the transaction occurred. Ex. "2024-04-17T02:14:25.68771" | | transaction\_version | bigint | | Blockchain version of the transaction. Ex. 2 | | type | String | | Type of the transaction, described by a Move entry function. Ex. "0x1::coin::WithdrawEvent" | | Index Name | Indexed Columns | | ------------------------------ | -------------------------------- | | faa\_at\_index | asset\_type | | faa\_gfpa\_index | gas\_fee\_payer\_address | | faa\_insat\_idx | inserted\_at | | faa\_owner\_type\_index | owner\_address, type | | faa\_si\_index | storage\_id | | fungible\_asset\_activities\_pkey | transaction\_version, event\_index | ### `current_fungible_asset_balances` _Has an aggregate view for summary data called `current_fungible_asset_balances_aggregate`_ This tracks the asset balances of each account on-chain. It includes v1 token data. | Field | Type | Primary Key | Description | | -------------------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount | bigint | | The amount of the asset owned. Ex. 2000 | | asset\_type | String | | The type of the asset, described by a Move resource. For v2 tokens this is the address of the fungible asset metadata object. For v1 it's the fully qualified path of the move resource. Ex. "0x1::aptos\_coin::AptosCoin" | | is\_frozen | Boolean | | Indicates whether the account is frozen. Ex. False | | is\_primary | Boolean | | Indicates whether this is the primary balance of the owner. Ex. True | | last\_transaction\_timestamp | String | | Timestamp of the last transaction involving this balance. Ex. "2024-04-17T02:14:25.68771" | | last\_transaction\_version | bigint | | Blockchain version of the last transaction involving this balance. Ex. 30000000 | | metadata | Object | | Use the [Hasura explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/v1/graphql) to see fields for `metadata` in `current_fungible_asset_balances`. | | owner\_address | String | | This is an Aptos account address that owns the asset. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | storage\_id | String | Yes | Identifier for the storage associated with this balance. IDs must be 66 characters long, and so may be 0 padded. Ex. "0xa815a9a09105973084bfc31530e7c8f002846787c2f0521e1e34dc144ad83b89" | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | | Index Name | Indexed Columns | | -------------------------------------------- | ------------------------- | | cufab\_insat\_index | inserted\_at | | cufab\_owner\_at\_index | owner\_address, asset\_type | | current\_unified\_fungible\_asset\_balances\_pkey | storage\_id | ## Delegated Staking With [AIP-6](https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-6.md) we added the ability for staking pools to be formed with delegated funds (delegation pools). Once these pools hold over 1M APT, they can become a staking pool (validator node). ### `current_delegated_staking_pool_balances` This table tracks the current balances of each account in a delegated staking pool. | Field | Type | Primary Key | Description | |------------------------------|--------|-------------|-----------------------------------------------------------------------------| | staking\_pool\_address | String | Yes | The address of the delegation pool. | | total\_coins | bigint | | Amount of APT in the staking pool. | | total\_shares | bigint | | The total number of shares in the delegation pool. | | operator\_commission\_percentage | bigint | | The commission percentage taken by the staking pool operator. | | inactive\_table\_handle | String | | The table handle for the inactive table. | | active\_table\_handle | String | | The table handle for the active table. | | last\_transaction\_version | int8 | | Transaction version (identifier) for the last transaction involving this staking pool. | | inserted\_at | String | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | current\_delegated\_staking\_pool\_balances\_pkey | staking\_pool\_address | ### `current_delegated_voter` This table tracks the current delegated voters of a delegation pool. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | delegation\_pool\_address | String | Yes | The address of the delegation pool. | | delegator\_address | String | Yes | The address of the delegator. | | table\_handle | String | | The table handle tracking this position. | | voter | String | | The address of the current voter in the delegation pool. | | pending\_voter | String | | The address of the pending voter awaiting confirmation. | | last\_transaction\_version | bigint | | The transaction version (identifier) of the last transaction involving this delegation. | | last\_transaction\_timestamp | Timestamp | | The block timestamp of the last transaction involving this delegation. | | inserted\_at | Timestamp | | The timestamp when the record was inserted into the database. | | Index Name | Indexed Columns | |------------|----------------| | current\_delegated\_voter\_pkey | delegation\_pool\_address, delegator\_address | | cdv\_da\_index | delegator\_address | ### `current_delegator_balances` This table tracks the current balances of each account in a delegated staking pool. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | delegator\_address | String | Yes | The address of the delegator. | | pool\_address | String | | The address of the delegator pool. | | pool\_type | String | | If the shares are active or inactive | | table\_handle | String | | The table handle for the pool. | | shares | bigint | | The number of shares in the pool. | | parent\_table\_handle | String | | The table handle for the parent table. | | last\_transaction\_version | bigint | | Transaction version (identifier) for the last transaction involving this staking pool. | | inserted\_at | Timestamp | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | current\_delegator\_balances\_pkey | delegator\_address, pool\_address, pool\_type, table\_handle | ### `current_staking_pool_voter` This table tracks the current voters of a staking pool. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | staking\_pool\_address | String | Yes | The address of the staking pool. | | voter\_address | String | | The address of the voter. | | operator\_address | String | | The address of the operator. | | last\_transaction\_version | bigint | | Transaction version (identifier) for the last transaction involving this staking pool. | | inserted\_at | Timestamp | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | current\_staking\_pool\_voter\_pkey | staking\_pool\_address | | ctpv\_va\_index | voter\_address | | ctpv\_insat\_index | inserted\_at | ### `delegated_staking_activities` This table tracks delegated staking events. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | transaction\_version | bigint | | Transaction version (identifier) for activity | | event\_index | bigint | | The index of the event. Ex. 1 | | delegator\_address | String | | The address of the delegator. | | pool\_address | String | | The address of the pool. | | event\_type | String | | DistributeRewards, AddStake, UnlikeStake, ReactiveStake, WithdrawStake | | amount | bigint | | The amount being staked. Ex. 1000 | | inserted\_at | Timestamp | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | delegated\_staking\_activities\_pkey | transaction\_version, event\_index | | dsa\_pa\_da\_index | pool\_address, delegator\_address, transaction\_version, event\_index | | dsa\_insat\_index | inserted\_at | ### `delegated_staking_pool_balances` This table tracks the historical balances of each account in a delegated staking pool. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | transaction\_version | bigint | | Transaction version (identifier) for activity | | staking\_pool\_address | String | | The address of the delegation pool. | | total\_coins | bigint | | Amount of APT in the staking pool. | | total\_shares | bigint | | The total number of shares in the delegation pool. | | operator\_commission\_percentage | bigint | | The commission percentage taken by the staking pool operator. | | inactive\_table\_handle | String | | The table handle for the inactive table. | | active\_table\_handle | String | | The table handle for the active table. | | inserted\_at | String | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | delegated\_staking\_pool\_balances\_pkey | transaction\_version, staking\_pool\_address | ### `delegated_staking_pools` This table tracks when a delegated pool was created. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | staking\_pool\_address | String | | The address of the staking pool. | | first\_transaction\_version | bigint | | The version number of the first transaction involving this pool. Ex. 5000000 | | inserted\_at | Timestamp | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | delegated\_staking\_pools\_pkey | staking\_pool\_address | ### `delegator_balances` This table tracks the historical balances of each account in a delegation pool. | Field | Type | Primary Key | Description | |----------------------------|--------|-------------|-------------| | transaction\_version | bigint | | The version number of the transaction. Ex. 5000000 | | write\_set\_change\_index | bigint | | The index of the write set change. Ex. 1 | | delegator\_address | String | | The address of the delegator. | | pool\_address | String | | The address of the delegator pool. | | pool\_type | String | | The type of the pool. Ex. "delegated" | | table\_handle | String | | The table handle for the pool. | | shares | bigint | | The number of shares in the pool. | | parent\_table\_handle | String | | The table handle for the parent table. | | inserted\_at | Timestamp | | The timestamp when the record was inserted. | | Index Name | Indexed Columns | |------------|----------------| | delegator\_balances\_pkey | transaction\_version, write\_set\_change\_index | ## Aptos Naming Service (ANS) ### `current_aptos_names` _Has an aggregate view for summary data called `current_aptos_names_aggregate`_ This view of [`current_ans_lookup_v2`](#current_ans_lookup_v2) helps query by name instead of account. | Field | Type | Primary Key | Description | | ------------------------ | ------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | domain | String | | The domain associated with this Aptos name. Ex. "example.crypto" | | domain\_with\_suffix | String | | The full domain name including any suffix. Ex. "example.crypto.aptos" | | expiration\_timestamp | String | | Timestamp when the domain registration expires. Ex. "2024-04-17T02:14:25.68771" | | is\_active | Boolean | | Indicates whether the domain is currently active. Ex. True | | is\_domain\_owner | Boolean | | Indicates whether the registered address is the owner of the domain. Ex. False | | is\_primary | Boolean | | Indicates whether this is the primary domain for the registered address. Ex. True | | last\_transaction\_version | bigint | | The version number of the last transaction involving this domain. Ex. 5000000 | | owner\_address | String | | This is an Aptos account address that owns the domain. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x123abc456def7890abcdef1234567890abcdef1234" | | registered\_address | String | | This is an Aptos account address registered to the domain. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | subdomain | String | | Any subdomain part of the domain name. Ex. "sub.example" | | token\_name | String | | The name of the token associated with this domain. Ex. "ExampleToken" | | token\_standard | String | | Aptos standard that the collection adheres to. Ex. "v1" | ### `current_ans_lookup_v2` This table maps tokens, standards, and addresses to human readable names. | Field | Type | Primary Key | Description | | ------------------------ | ------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | domain | String | Yes | The domain associated with this Aptos name. Ex. "example.crypto" | | expiration\_timestamp | String | | Timestamp when the domain registration expires. Ex. "2024-04-17T02:14:25.68771" | | is\_deleted | Boolean | | Indicates whether the domain registration has been deleted. Ex. False | | last\_transaction\_version | bigint | | The version number of the last transaction involving this domain. Ex. 5000000 | | registered\_address | String | | This is an Aptos account address registered to the domain. Addresses must be 66 characters long, and so may be 0 padded. Ex. "0x50bc83f01d48ab3b9c00048542332201ab9cbbea61bda5f48bf81dc506caa78a" | | subdomain | String | Yes | Any subdomain part of the domain name. Ex. "sub.example" | | token\_name | String | | The name of the token associated with this domain. Ex. "ExampleToken" | | token\_standard | String | Yes | Aptos standard that the collection adheres to. Ex. "v1" | | Index Name | Indexed Columns | | -------------------------- | --------------------------------- | | ans\_v2\_et\_index | expiration\_timestamp | | ans\_v2\_insat\_index | inserted\_at | | ans\_v2\_ra\_index | registered\_address | | ans\_v2\_tn\_index | token\_name, token\_standard | | current\_ans\_lookup\_v2\_pkey | domain, subdomain, token\_standard | ## Deprecated Tables The following tables are planned for deprecation, or are already deprecated. See the notes section for any direct replacements or notes on how to migrate if you currently depend on one of these tables. Please do not use any of the below tables for production services. | Table | Notes | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | address\_version\_from\_move\_resources | Replace with account\_transactions | | address\_events\_summary | To query custom events, you should create a [No-Code Indexer](https://geomi.dev/docs/no-code-indexing) | | address\_version\_from\_events | To query custom events, you should create a [No-Code Indexer](https://geomi.dev/docs/no-code-indexing) | | coin\_activities | Replace with fungible\_asset\_activities | | coin\_balances | Replace with current\_fungible\_asset\_balances | | coin\_infos | Replace with fungible\_asset\_metadata | | coin\_supply | No replacement; non-realtime APT coin supply is available with this [query](https://github.com/aptos-labs/explorer/blob/main/analytics/apt_supply.sql) | | collection\_datas | Replace with current\_collections\_v2 | | current\_ans\_lookup | Replace with current\_ans\_lookup\_v2 | | current\_coin\_balances | Replace with current\_fungible\_asset\_balances | | current\_collection\_datas | Replace with current\_collections\_v2 | | current\_token\_datas | Replace with current\_token\_datas\_v2 | | current\_token\_ownerships | Replace with current\_token\_ownerships\_v2 | | events\_view | To query custom events, you should create a [No-Code Indexer](https://geomi.dev/docs/no-code-indexing) | | move\_resources | Replace with account\_transactions | | move\_resources\_view | Replace with account\_transactions | | nft\_marketplace\_v2\_\* | Replace with [NFT Aggregator API](/build/indexer/nft-aggregator) | | token\_activities | Replace with token\_activities\_v2 | | token\_datas | Replace with current\_token\_datas\_v2 | | token\_ownerships | Replace with current\_token\_ownerships\_v2 | | tokens | Replace with current\_token\_datas\_v2 | | transactions | No replacement; non-realtime data is available in [BigQuery](https://console.cloud.google.com/marketplace/product/bigquery-public-data/crypto-aptos-mainnet-us) | | transactions\_view | No replacement; non-realtime data is available in [BigQuery](https://console.cloud.google.com/marketplace/product/bigquery-public-data/crypto-aptos-mainnet-us) | # Self-Hosted Indexer API > Deploy your own Aptos Indexer API with custom processors, database setup, and transaction stream integration for private data access import { Aside } from '@astrojs/starlight/components'; {/*
# NFT Aggregator Table Overview | Table Name | Description | | ------------------------------------------ | --------------------------------------------- | | `nft_marketplace_activities` | Historical data of all NFT marketplace events | | `current_nft_marketplace_listing` | Latest active listings per token | | `current_nft_marketplace_token_offer` | Latest active offers per token and buyer | | `current_nft_marketplace_collection_offer` | Latest active offers per collection | | `current_collections_v2` | Latest active collections | | `current_token_datas_v2` | Latest active tokens | | `current_token_ownerships_v2` | Latest active token ownerships | | `current_collection_ownerships_v2_view` | Latest active collection ownerships | ## Notes - Use `is_deleted = false` to query **only active** records in current state tables. - The `nft_marketplace_activities` table is your **source of truth** for historical marketplace activity. ## `nft_marketplace_activities` Historical table capturing all NFT marketplace events — listings, offers, sales, and more. Has an aggregate view for summary data called `nft_marketplace_activities_aggregate`. **Primary Key:** `txn_version, index, marketplace` ### Indexes | Index Name | Columns | | ------------------------- | -------------------------------------------------------- | | `idx_collection_event_ts` | collection\_id, standard\_event\_type, block\_timestamp DESC | | `idx_token_id` | token\_data\_id | | `idx_buyer` | buyer | | `idx_seller` | seller | | `idx_listing_id` | listing\_id | | `idx_offer_id` | offer\_id | | `idx_timestamp` | block\_timestamp DESC | ### Fields | Field | Type | Description | | ------------------- | -------------------- | --------------------------------------- | | txn\_version | i64 | Blockchain version of the transaction | | index | i64 | Event index in the transaction | | listing\_id | Option\
2. Add the Aptos NuGet package
Add the following line to the `This account normally pays the gas fees for this transaction. See [Sponsoring Transactions](/build/sdks/go-sdk/building-transactions/sponsoring-transactions) to learn how to have another account pay for transaction fees. 2. **The `Function` being called on-chain.**
This is the identifier for the smart contract entry function on-chain that will trigger when you execute this transaction. 3. **The `ArgTypes` and `Args`.**
This is any data the function needs to run. This can be made for a single account like so: ```go filename="build_a_transaction.go" // 1. Build transaction accountBytes, err := bcs.Serialize(&bob.Address) if err != nil { panic("Failed to serialize bob's address:" + err.Error()) } amountBytes, err := bcs.SerializeU64(TransferAmount) if err != nil { panic("Failed to serialize transfer amount:" + err.Error()) } rawTxn, err := client.BuildTransaction(alice.AccountAddress(), aptos.TransactionPayload{ Payload: &aptos.EntryFunction{ Module: aptos.ModuleId{ Address: aptos.AccountOne, Name: "aptos_account", }, Function: "transfer", ArgTypes: []aptos.TypeTag{}, Args: [][]byte{ accountBytes, amountBytes, }, }}, ) ``` #### Building Options You can customize the way your transaction executes by passing in `options` when building. Some of the most commonly used options are: 1. `MaxGasAmount` - This caps the amount of gas you are willing to pay for to execute this transaction. 2. `GasUnitPrice` - You can specify a higher than minimum price per gas to be executed with higher priority by the Aptos network. 3. `ExpirationSeconds` - This gives a concrete time the transaction must execute by or it will be canceled. The SDK provides sensible defaults for these values if they are not specified explicitly. 2. Simulate (Optional) Every transaction on the Aptos chain has a gas fee associated with how much work the network machines have to do when executing the transaction. In order to estimate the cost associated with that, you can simulate transactions before committing them. You can execute the simulation by using `aptos.SimulateTransaction` like so: ```go filename="build_a_transaction.go" // 2. Simulate transaction (optional) // This is useful for understanding how much the transaction will cost // and to ensure that the transaction is valid before sending it to the network // This is optional, but recommended simulationResult, err := client.SimulateTransaction(rawTxn, alice) // If the fee looks ok, continue to signing! ``` 3. Sign Once the transaction is built and the fees seem reasonable, you can sign the transaction with `rawTransaction.SignedTransaction()`. The signature must come from the `sender` account. ```go filename="build_a_transaction.go" // 3. Sign transaction signedTxn, err := rawTxn.SignedTransaction(alice) ``` 4. Submit Now that the transaction is signed, you can submit it to the network using `client.SubmitTransaction()` like so: ```go filename="build_a_transaction.go" // 4. Submit transaction submitResult, err := client.SubmitTransaction(signedTxn) ``` 5. Wait Finally, you can wait for the result of the transaction by using `client.WaitForTransaction()` and specifying the hash of the transaction you just submitted like so: ```go filename="build_a_transaction.go" // 5. Wait for the transaction to complete txnHash := submitResult.Hash _, err = client.WaitForTransaction(txnHash) ```
The TypeScript SDK allows you to connect, explore, and interact on the Aptos blockchain. You can use it to request data, send transactions, set up test environments, and more!
```shellscript npm2yarn
npm i @aptos-labs/ts-sdk
```
## Examples
Wallet Adapter Example
```tsx export default function useEnableAbstraction() { const { account, signTransaction } = useWallet(); return { enableAbstraction: async () => { if (!account) return; // Note: The Aptos client must be defined somewhere in the application. const transaction = aptos.abstraction.enableAccountAbstractionTransaction({ accountAddress: account.address, authenticationFunction: `${deployer}::hello_world_authenticator::authenticate`, }); const senderAuthenticator = await signTransaction(txn); const pendingTxn = await aptos.transaction.submit.simple({ transaction: txn, senderAuthenticator, }); return await aptos.waitForTransaction({ hash: pendingTxn.hash }); } } } ```This account normally pays the gas fees for this transaction. See [Transaction Sponsoring](/build/sdks/ts-sdk/building-transactions/sponsoring-transactions) to learn how to have another account pay for fees. 2. **The `function` being called on-chain.**
This is the identifier for the smart contract entry function on-chain that will trigger when you execute this transaction. 3. **The `functionArguments`.**
This is any data the function needs to run. This can be packaged into a `SimpleTransaction` using `aptos.transaction.build.simple(...)` like so: ```typescript filename="build-a-transaction.ts" const transaction = await aptos.transaction.build.simple({ sender: sender.accountAddress, data: { // All transactions on Aptos are implemented via smart contracts. function: "0x1::aptos_account::transfer", functionArguments: [destination.accountAddress, 100], }, }); ``` #### Building Options You can customize the way your transaction executes by passing in `options: {...}` when building. Some of the most commonly used options are: 1. `maxGasAmount` - This caps the amount of gas you are willing to pay for to execute this transaction. 2. `gasUnitPrice` - You can specify a higher than minimum price per gas to be executed with higher priority by the Aptos network. 3. `expireTimestamp` - This gives a concrete time the transaction must execute by or it will be canceled. The SDK provides sensible defaults for these values if they are not specified explicitly. 2. Simulate (Optional) Every transaction on the Aptos chain has a gas fee associated with how much work the network machines have to do when executing the transaction. In order to estimate the cost associated with that, you can simulate transactions before committing them. You can execute the simulation by using `aptos.transaction.simulate.simple(...)` like so: ```typescript filename="build-a-transaction.ts" const [userTransactionResponse] = await aptos.transaction.simulate.simple({ signerPublicKey: signer.publicKey, transaction, }); // If the fee looks ok, continue to signing! ``` 3. Sign Once the transaction is built and the fees seem reasonable, you can sign the transaction with `aptos.transaction.sign`. The signature must come from the `sender` account. ```typescript filename="build-a-transaction.ts" // 3. Sign const senderAuthenticator = aptos.transaction.sign({ signer: sender, transaction, }); ``` 4. Submit Now that the transaction is signed, you can submit it to the network using `aptos.transaction.submit.simple` like so: ```typescript filename="build-a-transaction.ts" // 4. Submit const committedTransaction = await aptos.transaction.submit.simple({ transaction, senderAuthenticator, }); ``` 5. Wait Finally, you can wait for the result of the transaction by using [`aptos.waitForTransaction`](https://aptos-labs.github.io/aptos-ts-sdk/@aptos-labs/ts-sdk-1.35.0/classes/Aptos.html#waitForTransaction) and specifying the hash of the transaction you just submitted like so: ```typescript filename="build-a-transaction.ts" // 5. Wait const executedTransaction = await aptos.waitForTransaction({ transactionHash: committedTransaction.hash }); ```
Example Output
```shellscript filename="Terminal" { version: '9534925', hash: '0xea50b6fbea39ad1ba015d11cda0e7478334669c34830bc3df067a260d680893c', state_change_hash: '0x0000000000000000000000000000000000000000000000000000000000000000', event_root_hash: '0x0000000000000000000000000000000000000000000000000000000000000000', state_checkpoint_hash: null, gas_used: '9', success: true, vm_status: 'Executed successfully', accumulator_root_hash: '0x0000000000000000000000000000000000000000000000000000000000000000', changes: [ { address: '0x811d5a94ccb597fa2a4f7872a3c678867cff94130d9378c39304c1354ef54abe', state_key_hash: '0x09adecee8779b64d05847488e2dbec6679c0c9e2fe618caf0793472ba3a7e4ab', data: [Object], type: 'write_resource' }, { address: '0x811d5a94ccb597fa2a4f7872a3c678867cff94130d9378c39304c1354ef54abe', state_key_hash: '0x0c70ede5412277b81d9f8d99369930ed5d56ad65862e3e878ad22dd5500833d0', data: [Object], type: 'write_resource' }, { address: '0xf40c314051890d16ba0a2ba427e003a83e730956fdeccf6c8eebc893a229ddc1', state_key_hash: '0x503f9cffb248036da24e18875f3dce72bb33d1d3ef5cfdbdb2fb3411cd718f4f', data: [Object], type: 'write_resource' }, { state_key_hash: '0x6e4b28d40f98a106a65163530924c0dcb40c1349d3aa915d108b4d6cfc1ddb19', handle: '0x1b854694ae746cdbd8d44186ca4929b2b337df21d1c74633be19b2710552fdca', key: '0x0619dc29a0aac8fa146714058e8dd6d2d0f3bdf5f6331907bf91f3acd81e6935', value: '0x708f579f62cb01000100000000000000', data: null, type: 'write_table_item' } ], sender: '0x811d5a94ccb597fa2a4f7872a3c678867cff94130d9378c39304c1354ef54abe', sequence_number: '0', max_gas_amount: '200000', gas_unit_price: '100', expiration_timestamp_secs: '1718983701', payload: { function: '0x1::aptos_account::transfer', type_arguments: [], arguments: [ '0xf40c314051890d16ba0a2ba427e003a83e730956fdeccf6c8eebc893a229ddc1', '100' ], type: 'entry_function_payload' }, signature: { public_key: '0x966b6b9aa8feb58ee1b911235dea1f185b9169de56303d18bb59937066881e44', signature: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', type: 'ed25519_signature' }, events: [ { guid: [Object], sequence_number: '0', type: '0x1::coin::CoinWithdraw', data: [Object] }, { guid: [Object], sequence_number: '0', type: '0x1::coin::WithdrawEvent', data: [Object] }, { guid: [Object], sequence_number: '0', type: '0x1::coin::CoinDeposit', data: [Object] }, { guid: [Object], sequence_number: '1', type: '0x1::coin::DepositEvent', data: [Object] }, { guid: [Object], sequence_number: '0', type: '0x1::transaction_fee::FeeStatement', data: [Object] } ], timestamp: '1718983681460047' } ```For versions prior to v4.0.0
### (Optional) Install the plugins for any “Legacy Standard Compatible” Wallets you want to support from [this list](https://github.com/aptos-labs/aptos-wallet-adapter/blob/main/README.md#supported-wallet-packages). For wallets that have not updated to using the AIP-62 standard, their plugins must be installed and passed in to the `Provider` manually. For example: ```shellscript filename="Terminal" npm i @okwallet/aptos-wallet-adapter ``` ### In `App.tsx` or it’s equivalent, import the Aptos Wallet Adapter and any legacy Wallet plugins. ```tsx filename="App.tsx" import { AptosWalletAdapterProvider } from "@aptos-labs/wallet-adapter-react"; // Import any additional wallet plugins. Ex. import { OKXWallet } from "@okwallet/aptos-wallet-adapter"; // ... ```
{wallets.map(wallet => {
return
)
}
```
#### Support for Uninstalled Wallets
Following AIP-62, the adapter uses an event-based communication model between a wallet and a dapp. This means only wallets installed in the user's browser are detected automatically and available for use.
To support the full Aptos wallet ecosystem, the adapter maintains a registry of supported wallets—allowing dapps to also display uninstalled wallets. It also exposes a utility function to easily manage all wallets.
```tsx filename="WalletDisplayDemo.tsx"
import { useWallet, groupAndSortWallets } from '@aptos-labs/wallet-adapter-react';
const displayAllWalletsDemo = () => {
const { wallets = [], notDetectedWallets = [] } = useWallet();
const { aptosConnectWallets, availableWallets, installableWallets } =
groupAndSortWallets(
[...wallets, ...notDetectedWallets]
);
return (
{wallet.name}
})}
/** Wallets that use social login to create an account on the blockchain */
{aptosConnectWallets.map((aptosConnectwallet) => (
return
)
}
```
### `connect()` and `disconnect()`
`connect()` establishes a connection between the dapp and a Wallet. You can then use `disconnect()` to
```tsx filename="WalletConnectDemo.tsx"
import React from 'react';
import { WalletName, useWallet } from '@aptos-labs/wallet-adapter-react';
const WalletConnectDemo = () => {
const { connect, disconnect, account, connected } = useWallet();
const handleConnect = async () => {
try {
// Change below to the desired wallet name instead of "Petra"
await connect("Petra" as WalletName<"Petra">);
console.log('Connected to wallet:', account);
} catch (error) {
console.error('Failed to connect to wallet:', error);
}
};
const handleDisconnect = async () => {
try {
await disconnect();
console.log('Disconnected from wallet');
} catch (error) {
console.error('Failed to disconnect from wallet:', error);
}
};
return (
{aptosConnectwallet.name}
))} /** Wallets that are currently installed or loadable. */ {availableWallets.map((availableWallet) => ( return{availableWallet.name}
))} /** Wallets that are NOT currently installed or loadable. */ {installableWallets.map((installableWallet) => ( return{installableWallet.name}
))}Aptos Wallet Connection
{connected ? (
) : (
)}
Connected to: {account?.address}
Aptos Sign and Verify Message
{connected ? (
Connected to: {account?.address}