Specialized Types

AccountId

An AccountId is composed of a <shardNum>.<realmNum>.<accountNum> (eg. 0.0.10).

• Shard number (shardNum) represents the shard number (shardId). It will default to 0 today, as Hedera only performs in one shard.

• Realm number (realmNum) represents the realm number (realmId). It will default to 0 today, as realms are not yet supported.

• Account represents either an account number or an account alias

  • Account number (accountNum) represents the account number (accountId)

  • Account alias (alias) represented by the public key bytes

    • The public key bytes are the result of serializing a protobuf Key message for any primitive key type

    • Currently, only primitive key bytes are supported as an alias

    • Threshold keys, key list, contract ID, and delegatable_contract_id are not supported

    • The alias can only be used in place of an account ID in transfer transactions in its current version

Together these values make up your AccountId. When an AccountId is specified, be sure all three values are included.

Constructor

Methods

Example

Java

AccountId accountId = new AccountId(0 ,0 ,10);
System.out.println(accountId);

// Constructs an accountId from String
AccountId accountId = AccountId.fromString("0.0.10");
System.out.println(accountId);

JavaScript

const accountId = new AccountId(100);
console.log(`${accountId}`);

// Construct accountId from String
const accountId = AccountId.fromString(`100`);
console.log(`${accountId}`);

Go

hedera.AccountIDFromString("0.0.3")

FileId

A FileId is composed of a <shardNum>.<realmNum>.<fileNum> (eg. 0.0.15).

• shardNum represents the shard number (shardId). It will default to 0 today, as Hedera only performs in one shard.

• realmNum represents the realm number (realmId). It will default to 0 today, as realms are not yet supported.

• fileNum represents the file number

Together these values make up your accountId. When an FileId is requested, be sure all three values are included.

Constructor

Methods

Example

Java

FileId fileId = new FileId(0,0,15);
System.out.println(fileId);

//Constructs a FileId from string
FileId fileId = FileId.fromString("0.0.15");
System.out.println(fileId);

JavaScript

const newFileId = new FileId(100);
console.log(`${newFileId}`);

//Construct a fileId from a String
const newFileIdFromString = FileId.fromString(`100`); 
console.log(`${newFileIdFromString}`);

Go

hedera.FileIDFromString("0.0.3")

ContractId

A ContractId is composed of a <shardNum>.<realmNum>.<contractNum> (eg. 0.0.20).

• shardNum represents the shard number (shardId). It will default to 0 today, as Hedera only performs in one shard.

• realmNum represents the realm number (realmId). It will default to 0 today, as realms are not yet supported.

• contractNum represents the contract number

Together these values make up your ContractId. When an ContractId is requested, be sure all three values are included. ContractId's are automatically assigned when you create a new smart contract.

Constructor

Methods

Example

Java

ContractId contractId = new ContractId(0,0,20);
System.out.println(contractId);

// Constructs a ContractId from string
ContractId contractId = ContractId.fromString("0.0.20");
System.out.println(contractId);

JavaScript

const newContractId = new ContractId(100);
console.log(`${newContractId}`);

// Construct a contractId from a String
const newContractId = ContractId.fromString(`100`); 
console.log(`${newContractId}`);

Go

hedera.ContractIDFromString("0.0.3")

TopicId

A topicId is composed of a <shardNum>.<realmNum>.<topicNum> (eg. 0.0.100).

• shardNum represents the shard number (shardId). It will default to 0 today, as Hedera only performs in one shard.

• realmNum represents the realm number (realmId). It will default to 0 today, as realms are not yet supported.

• topicNum represents the topic number (topicId)

Constructor

Example

Java

ConsensusTopicId topicId = new ConsensusTopicId(0,0,100);
System.out.println(topicId)

JavaScript

const topicId = new ConsensusTopicId(0,0,100);
console.log(topicId)

Go

hedera.TopicIDFromString("0.0.3")