Slim account

docs/02_cleos/02_how-to-guides/how-to-create-a-slim-account.md

@@ -0,0 +1,49 @@
+## Overview
+
+This how-to guide provides instructions on how to create a new slim Antelope blockchain account using the `cleos` CLI tool. You can use accounts to deploy smart contracts and perform other related blockchain operations. Create one or multiple accounts as part of your development environment setup.
+
+The example in this how-to guide creates a new account named **ted**, authorized by the default system account **eosio**, using the `cleos` CLI tool.
+
+## Before you Begin
+
+Make sure you meet the following requirements:
+
+* Install the currently supported version of `cleos`.
+[[info | Note]]
+| The cleos tool is bundled with the Antelope software. [Installing Antelope](../../00_install/index.md) will also install the cleos tool.
+* Learn about [Antelope Accounts and Permissions](/protocol-guides/04_accounts_and_permissions.md)
+* Learn about Asymmetric Cryptography - [public key](/glossary.md#public-key) and [private key](/glossary.md#private-key) pairs.
+* Create public/private keypair for the `owner` permissions of an account.
+
+## Command Reference
+
+See the following reference guide for `cleos` command line usage and related options:
+* [`cleos create slimaccount`](../03_command-reference/create/slim_account.md) command and its parameters
+
+## Procedure
+
+The following step shows how to create a new account **ted** authorized by the default system account **eosio**.
+
+1. Run the following command to create the new account **ted**:
+
+```sh
+cleos create slimaccount eosio ted EOS87TQktA5RVse2EguhztfQVEh6XXxBmgkU8b4Y5YnGvtYAoLGNN
+```
+**Where**:
+* `eosio` = the system account that authorizes the creation of a new account
+* `ted` = the name of the new account conforming to [account naming conventions](/protocol-guides/04_accounts_and_permissions.md#2-accounts)
+* `EOS87TQ...AoLGNN` = the owner public key or permission level for the new account (**required**)
+[[info | Note]]
+| To create a new account in the Antelope blockchain, an existing account, also referred to as a creator account, is required to authorize the creation of a new account. For a newly created Antelope blockchain, the default system account used to create a new account is **eosio**.
+
+**Example Output**
+
+```console
+executed transaction: 80a54e6220ba90edfae2f35d1841f72660313337294685937ab4eedf422a26d8  152 bytes  139 us
+#         eosio <= eosio::newslimacc            "0000000000ea305500000000000092ca01000000010003a887c1d7893cb40746c6f8fc6e0a964320d0316b85c6ebc8c905a...
+warning: transaction executed locally, but may not be confirmed by the network yet         ] 
+```
+
+### Summary
+
+By following these instructions, you are able to create a new slim Antelope account in your blockchain environment.

docs/02_cleos/03_command-reference/create/slim_account.md

@@ -0,0 +1,107 @@
+## Description
+Create a new slim account on the blockchain (assumes system contract does not restrict RAM usage)
+
+## Usage
+
+```console
+Usage: cleos create slimaccount [OPTIONS] creator name OwnerKey
+
+Positionals:
+  creator TEXT                The name of the account creating the new account (required)
+  name TEXT                   The name of the new account (required)
+  OwnerKey TEXT              The owner public key or permission level for the new account
+
+Options:
+  -h,--help                   Print this help message and exit
+  -x,--expiration             set the time in seconds before a transaction expires, defaults to 30s
+  -f,--force-unique           force the transaction to be unique. this will consume extra bandwidth and remove any protections against accidently issuing the same transaction multiple times
+  -s,--skip-sign              Specify if unlocked wallet keys should be used to sign transaction
+  -j,--json                   print result as json
+  --json-file TEXT            save result in json format into a file
+  -d,--dont-broadcast         don't broadcast transaction to the network (just print to stdout)
+  --return-packed             used in conjunction with --dont-broadcast to get the packed transaction
+  -r,--ref-block TEXT         set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
+  --use-old-rpc               use old RPC push_transaction, rather than new RPC send_transaction
+  -p,--permission TEXT ...    An account and permission level to authorize, as in 'account@permission' (defaults to 'creator@active')
+  --max-cpu-usage-ms UINT     set an upper limit on the milliseconds of cpu usage budget, for the execution of the transaction (defaults to 0 which means no limit)
+  --max-net-usage UINT        set an upper limit on the net usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
+  --delay-sec UINT            set the delay_sec seconds, defaults to 0s
+```
+
+## Command
+A set of Antelope keys is required to create an account. The Antelope keys can be generated by using `cleos create key`.
+
+```sh
+cleos create slimaccount eosio alice EOS4toFS3YXEQCkuuw1aqDLrtHim86Gz9u3hBdcBw5KNPZcursVHq 
+```
+
+## Output
+
+```json
+{
+  "transaction_id": "089e813085a99d854a3e6425fddd63d9fb6cfa1b11ebf807f134d0be1046bc2b",
+  "processed": {
+    "id": "089e813085a99d854a3e6425fddd63d9fb6cfa1b11ebf807f134d0be1046bc2b",
+    "block_num": 222,
+    "block_time": "2024-01-15T15:54:26.500",
+    "producer_block_id": null,
+    "receipt": {
+      "status": "executed",
+      "cpu_usage_us": 138,
+      "net_usage_words": 19
+    },
+    "elapsed": 138,
+    "net_usage": 152,
+    "scheduled": false,
+    "action_traces": [{
+        "action_ordinal": 1,
+        "creator_action_ordinal": 0,
+        "closest_unnotified_ancestor_action_ordinal": 0,
+        "receipt": {
+          "receiver": "eosio",
+          "act_digest": "bfe408bd33f540cb6696d1a3a0a28ade8e72c5206b7de25f2b24589b41518725",
+          "global_sequence": 233,
+          "recv_sequence": 233,
+          "auth_sequence": [[
+              "eosio",
+              233
+            ]
+          ],
+          "code_sequence": 0,
+          "abi_sequence": 0
+        },
+        "receiver": "eosio",
+        "act": {
+          "account": "eosio",
+          "name": "newslimacc",
+          "authorization": [{
+              "actor": "eosio",
+              "permission": "active"
+            }
+          ],
+          "data": "0000000000ea30550000000000855c340100000001000200b35ad060d629717bd3dbec82731094dae9cd7e9980c39625ad58fa7f9b654b01000000",
+          "hex_data": "0000000000ea30550000000000855c340100000001000200b35ad060d629717bd3dbec82731094dae9cd7e9980c39625ad58fa7f9b654b01000000"
+        },
+        "context_free": false,
+        "elapsed": 43,
+        "console": "",
+        "trx_id": "089e813085a99d854a3e6425fddd63d9fb6cfa1b11ebf807f134d0be1046bc2b",
+        "block_num": 222,
+        "block_time": "2024-01-15T15:54:26.500",
+        "producer_block_id": null,
+        "account_ram_deltas": [{
+            "account": "alice",
+            "delta": 2210
+          }
+        ],
+        "except": null,
+        "error_code": null,
+        "return_value_hex_data": ""
+      }
+    ],
+    "account_ram_delta": null,
+    "except": null,
+    "error_code": null
+  }
+}
+```

docs/02_cleos/03_command-reference/system/system-newslimacc.md

@@ -0,0 +1,27 @@
+## Description
+
+Create a slim account, buy ram, stake for bandwidth for the account
+
+## Positional Arguments
+- `creator` _TEXT_  - The name of the account creating the new account
+- `name` _TEXT_  - The name of the new account
+- `ownerKey` _TEXT_  - The owner public key for the new account
+## Options
+- `-h,--help` Print this help message and exit
+- `--stake-net` _TEXT_ - The amount of EOS delegated for net bandwidth
+- `--stake-cpu` _TEXT_  - The amount of EOS delegated for CPU bandwidth
+- `--buy-ram-bytes` _UINT_ - The amount of RAM bytes to purchase for the new account in kilobytes KiB, default is 8 KiB
+- `--buy-ram-EOS` _TEXT_ - The amount of RAM bytes to purchase for the new account in EOS
+- `--transfer` - Transfer voting power and right to unstake EOS to receiver
+- `-x,--expiration` _TEXT_ - set the time in seconds before a transaction expires, defaults to 30s
+- `-f,--force-unique` - force the transaction to be unique. this will consume extra bandwidth and remove any protections against accidently issuing the same transaction multiple times
+- `-s,--skip-sign` Specify if unlocked wallet keys should be used to sign transaction
+- `-d,--dont-broadcast` - Don't broadcast transaction to the network (just print to stdout)
+- `-r,--ref-block` _TEXT_         set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
+- `-p,--permission`  _TEXT_ - An account and permission level to authorize, as in 'account@permission' (defaults to 'account@active')
+- `--max-cpu-usage-ms` _UINT_ - set an upper limit on the milliseconds of cpu usage budget, for the execution of the transaction (defaults to 0 which means no limit)
+- `--max-net-usage` _UINT_ - set an upper limit on the net usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
+- `--delay-sec` _UINT_            set the delay_sec seconds, defaults to 0s
+- `-j,--json` print result as json
+
+## Examples

libraries/chain/apply_context.cpp

@@ -66,7 +66,8 @@ void apply_context::exec_one()
 
    digest_type act_digest;
 
-   const account_metadata_object* receiver_account = nullptr;
+   const account_object* receiver_account = nullptr;
+   const account_metadata_object* receiver_account_metadata = nullptr;
 
    auto handle_exception = [&](const auto& e)
    {
@@ -80,9 +81,10 @@ void apply_context::exec_one()
    try {
       try {
          action_return_value.clear();
-         receiver_account = &db.get<account_metadata_object,by_name>( receiver );
-         if( !(context_free && control.skip_trx_checks()) ) {
-            privileged = receiver_account->is_privileged();
+         receiver_account = &db.get<account_object,by_name>( receiver );
+         receiver_account_metadata = db.find<account_metadata_object,by_name>( receiver );
+         if( receiver_account_metadata != nullptr && !(context_free && control.skip_trx_checks()) ) {
+            privileged = receiver_account_metadata->is_privileged();
             auto native = control.find_apply_handler( receiver, act->account, act->name );
             if( native ) {
                if( trx_context.enforce_whiteblacklist && control.is_speculative_block() ) {
@@ -92,7 +94,7 @@ void apply_context::exec_one()
                (*native)( *this );
             }
 
-            if( ( receiver_account->code_hash != digest_type() ) &&
+            if( ( receiver_account_metadata->code_hash != digest_type() ) &&
                   (  !( act->account == config::system_account_name
                         && act->name == "setcode"_n
                         && receiver == config::system_account_name )
@@ -104,7 +106,7 @@ void apply_context::exec_one()
                   control.check_action_list( act->account, act->name );
                }
                try {
-                  control.get_wasm_interface().apply( receiver_account->code_hash, receiver_account->vm_type, receiver_account->vm_version, *this );
+                  control.get_wasm_interface().apply( receiver_account_metadata->code_hash, receiver_account_metadata->vm_type, receiver_account_metadata->vm_version, *this );
                } catch( const wasm_exit& ) {}
             }
 
@@ -155,10 +157,10 @@ void apply_context::exec_one()
       handle_exception(wrapper);
    }
 
-   // Note: It should not be possible for receiver_account to be invalidated because:
+   // Note: It should not be possible for receiver_account_metadata to be invalidated because:
    //    * a pointer to an object in a chainbase index is not invalidated if other objects in that index are modified, removed, or added;
    //    * a pointer to an object in a chainbase index is not invalidated if the fields of that object are modified;
-   //    * and, the *receiver_account object itself cannot be removed because accounts cannot be deleted in EOSIO.
+   //    * and, the *receiver_account_metadata object itself cannot be removed because accounts cannot be deleted in EOSIO.
 
    action_trace& trace = trx_context.get_action_trace( action_ordinal );
    trace.return_value  = std::move(action_return_value);
@@ -170,15 +172,15 @@ void apply_context::exec_one()
    r.global_sequence  = next_global_sequence();
    r.recv_sequence    = next_recv_sequence( *receiver_account );
 
-   const account_metadata_object* first_receiver_account = nullptr;
+   const account_metadata_object* first_receiver_account_metadata = nullptr;
    if( act->account == receiver ) {
-      first_receiver_account = receiver_account;
+      first_receiver_account_metadata = receiver_account_metadata;
    } else {
-      first_receiver_account = &db.get<account_metadata_object, by_name>(act->account);
+      first_receiver_account_metadata = db.find<account_metadata_object, by_name>(act->account);
    }
 
-   r.code_sequence    = first_receiver_account->code_sequence; // could be modified by action execution above
-   r.abi_sequence     = first_receiver_account->abi_sequence;  // could be modified by action execution above
+   r.code_sequence    = first_receiver_account_metadata != nullptr ? first_receiver_account_metadata->code_sequence : 0; // could be modified by action execution above
+   r.abi_sequence     = first_receiver_account_metadata != nullptr ? first_receiver_account_metadata->abi_sequence: 0;  // could be modified by action execution above
 
    for( const auto& auth : act->authorization ) {
       r.auth_sequence[auth.actor] = next_auth_sequence( auth.actor );
@@ -1053,7 +1055,7 @@ uint64_t apply_context::next_global_sequence() {
    }
 }
 
-uint64_t apply_context::next_recv_sequence( const account_metadata_object& receiver_account ) {
+uint64_t apply_context::next_recv_sequence( const account_object& receiver_account ) {
    if ( trx_context.is_read_only() ) {
       // To avoid confusion of duplicated receive sequence number, hard code to be 0.
       return 0;
@@ -1065,11 +1067,11 @@ uint64_t apply_context::next_recv_sequence( const account_metadata_object& recei
    }
 }
 uint64_t apply_context::next_auth_sequence( account_name actor ) {
-   const auto& amo = db.get<account_metadata_object,by_name>( actor );
-   db.modify( amo, [&](auto& am ){
-      ++am.auth_sequence;
+   const auto& ao = db.get<account_object,by_name>( actor );
+   db.modify( ao, [&](auto& a ){
+      ++a.auth_sequence;
    });
-   return amo.auth_sequence;
+   return ao.auth_sequence;
 }
 
 void apply_context::add_ram_usage( account_name account, int64_t ram_delta ) {