Skip to content

Latest commit

 

History

History
192 lines (127 loc) · 6.01 KB

AccountCreateTransaction.md

File metadata and controls

192 lines (127 loc) · 6.01 KB

class AccountCreateTransaction extends Transaction

Create a new account. After the account is created, the AccountID for it is in the receipt. It can also be retrieved with a GetByKey query. Threshold values can be defined, and records are generated and stored for 25 hours for any transfer that exceeds the thresholds. This account is charged for each record generated, so the thresholds are useful for limiting record generation to happen only for large transactions.

The Key field is the key used to sign transactions for this account. If the account has receiverSigRequired set to true, then all cryptocurrency transfers must be signed by this account's key, both for transfers in and out. If it is false, then only transfers out have to be signed by it. When the account is created, the payer account is charged enough hbars so that the new account will not expire for the next autoRenewPeriod seconds. When it reaches the expiration time, the new account will then be automatically charged to renew for another autoRenewPeriod seconds. If it does not have enough hbars to renew for that long, then the remaining hbars are used to extend its expiration as long as possible. If it has a zero balance when it expires, then it is deleted. This transaction must be signed by the payer account. If receiverSigRequired is false, then the transaction does not have to be signed by the keys in the keys field. If it is true, then it must be signed by them, in addition to the keys of the payer account.

An entity (account, file, or smart contract instance) must be created in a particular realm. If the realmID is left null, then a new realm will be created with the given admin key. If a new realm has a null adminKey, then anyone can create/modify/delete entities in that realm. But if an admin key is given, then any transaction to create/modify/delete an entity in that realm must be signed by that key, though anyone can still call functions on smart contract instances that exist in that realm. A realm ceases to exist when everything within it has expired and no longer exists.

The current API ignores shardID, realmID, and newRealmAdminKey, and creates everything in shard 0 and realm 0, with a null key. Future versions of the API will support multiple realms and multiple shards.

Warning

When creating a new account an existing account will need to fund the initial balance and pay for the transaction fee.

** Java **

var key = PrivateKey.generate();

var accountId = new AccountCreateTransaction()
    .setKey(key)
    .setInitialBalance(new Hbar(10)) // 10 hbars
    .setEvmAddress(evmAddress) // bytes
    .execute(client) // TransactionResponse
    .getReceipt(client) // TransactionReceipt
    .accountId // Nullable<AccountId>

** JavaScript **

const key = PrivateKey.generate();

const transaction = new AccountCreateTransaction({
    key: newKey,
    initialBalance: new Hbar(10),
    evmAddress: evmAddress,

});

const response = await accountCreateTransaction.execute(client) // TransactionResponse;
const receipt = await response.getReceipt(client) // TransactionReceipt;
const accountId = receipt.accountId // Nullable<AccountId>;
  • Duration is number and is the number of seconds

** Go **

newKey := hedera.GeneratePrivateKey()

response, err := hedera.NewAccountCreateTransaction().
    SetKey(newKey).
    SetInitialBalance(10 * hedera.Hbar) // 10 Hbars
    SetEvmAddress(evmAddress) // bytes
    Execute(client) // TransactionResponse
if err != nil {
    println(err.Error())
}

receipt, err := response.GetReceipt(client)
if err != nil {
    println(err.Error())
}

accountID := *receipt.AccountID

Constructor

constructor()

Properties

accountMemo: String

The memo associated with the account (UTF-8 encoding max 100 bytes)

alias: EvmAddress

The bytes to be used as the account's alias.

The bytes must be formatted as the calculated last 20 bytes of the keccak-256 of the ECDSA primitive key.

All other types of keys, including but not limited to ED25519, ThresholdKey, KeyList, ContractID, and delegatable_contract_id, are not supported.

At most only one account can ever have a given alias on the network.

autoRenewPeriod: Duration

The account is charged to extend its expiration date every this many seconds. If it doesn't have enough balance, it extends as long as possible. If it is empty when it expires, then it is deleted.

Defaults to 90 days (or 7,776,000 seconds).

declineStakingReward: bool

If true, the account declines receiving a staking reward. The default value is false.

initialBalance: Hbar

The initial number of tinybars to put into the account

Defaults to 0.

key: Key

The key that must sign each transfer out of the account. If receiverSigRequired is true, then it must also sign any transfer into the account.

maxAutomaticTokenAssociations: Uint32

The maximum number of tokens that an Account can be implicitly associated with. Defaults to 0 and up to a maximum value of 1000.

proxyAccountId: AccountId

Deprecated: with no replacement

ID of the account to which this account is proxy staked. If proxyAccountID is null, or is an invalid account, or is an account that isn't a node, then this account is automatically proxy staked to a node chosen by the network, but without earning payments. If the proxyAccountID account refuses to accept proxy staking , or if it is not currently running a node, then it will behave as if proxyAccountID was null.

receiverSignatureRequired: bool

If true, this account's key must sign any transaction depositing into this account (in addition to all withdrawals)

Defaults to false.

stakedNodeAccountId: ?AccountId

ID of the account to which this contract is staking.

stakedNodeId: ?Int64

ID of the node this contract is staked to.