Support Arbitrary Shards & Realms

[0xivanov]

Description

The SDKs must support non-zero realm numbers in entity IDs (such as 0.100.0) since Spheres will populate realm values.

We need to validate the SDKs support the following:

• Specifying a realm number during entity ID construction
• Using entity IDs with specified realm numbers in transactions
• Eliminating code that assumes zero for shards and realms

Updated APIs

Several APIs currently offered by the SDKs do not offer support for setting the shard and realm of an entity even though the protobufs do. This will need to be updated to allow the protobuf values to be filled out.

ContractCreateTransaction

• int64 shard : The shard in which to create the new contract.
  • ContractCreateTransaction setShard(int64)
  • int64 getShard()
• int64 realm: The realm in which to create the new contract.
  • ContractCreateTransaction setRealm(int64)
  • int64 getRealm()

FileCreateTransaction

• int64 shard : The shard in which to create the new file.
  • FileCreateTransaction setShard(int64)
  • int64 getShard()
• int64 realm: The realm in which to create the new file.
  • FileCreateTransaction setRealm(int64)
  • int64 getRealm()

AccountCreateTransaction

• int64 shard : The shard in which to create the new account.
  • AccountCreateTransaction setShard(int64)
  • int64 getShard()
• int64 realm: The realm in which to create the new account.
  • AccountCreateTransaction setRealm(int64)
  • int64 getRealm()