Skip to content

v3.0.0-beta1

Latest
Latest
Compare
Choose a tag to compare
@davidatwhiletrue davidatwhiletrue released this 12 Jul 12:38
· 3 commits to master since this release
v3.0.0-beta1
7431909
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

Casper .NET SDK v3.0.0-beta1

This is a beta version of the Casper.NET SDK v3.0. It is compatible with Casper node v2.0.0-rc3 and Casper node v1.5.6. This new version introduces some breaking changes. Read the changelog below in detail and the migration guide.

Added

  • New GetEntity() method added to the RPC client.
  • New QueryBalanceDetails() method added to the RPC client.
  • New PutTransaction() and GetTransaction() methods added to the RPC client.
  • New TransactionV1 class to model the new type of transactions in Condor.
  • New global state keys added to the SDK: AddressableEntityKey, BalanceHoldKey, BidAddrKey, BlockGlobalAddrKey, ByteCodeKey, EntryPointKey, MessageKey, NamedKeyKey and PackageKey.
  • New AddressableEntity class added. It may represent an account, a stored smart contract, or a system smart contract.
  • New properties in the StoredValue class that can be retrieved with QueryGlobalState() method: BidKind, Unbonding, AddressableEntity, Package, ByteCode, MessageTopicSummary, Message, NamedKey, Reservation, and EntryPoint.
  • New classes to represent data from the global state: BidKind, UnbondingPurse, Package and ByteCode.
  • New Message class to contain data for native events included in the TransactionAccepted event from the SSE channel.
  • Added TransactionAccepted, TransactionProcessed, and TransactionExpired events to the list of events emitted by a node through the SSE interface.

Changed

  • The Block class has changed to abstract the developer from the versioned block records returned from the network in Condor version. Refer to the migration guide for more information.
  • For blocks produced in Casper 2.0, the Block instance contains the previous switch block hash in the LastSwitchBlockHash property.
  • Ther EraEnd class has changed to abstract the developer from the versioned records returned from the network. More info in the migration guide.
  • The Transfer class contained in the response for a GetBlockTransfers() call or in a ExecutionResult object has changed to abstract from the versioned transfer records returned from the network. Refer to the migration guide for more information.
  • The input argument for the QueryBalance() method in the RPC client is any object from a class implementing the IPurseIdentifier interface. PublicKey, AccountHashKey, URef, and AddressableEntity classes implement this interface.
  • The type to refer to block heights is now ulong across all the SDK. In previous version there was a mix of ulong and int.
  • When using the GetNodeStatus() method with a Casper 2.0 node, the response contains the hash for the latest switch block in the LatestSwitchBlockHash property.
  • GetDeploy() response has changed and now contains a ExecutionInfoobject when the deploy has been processed instead a list of ExecutionResult objects. The execution info itself contains block information and a result object.
  • Starting with this version of the SDK, only public keys are checksummed with the CEP-57 standard. The rest of the keys and hashes are not checksummed anymore.
  • In the StoredValue class, Transfer has been renamed to LegacyTransfer.
  • DeployApproval class has been renamed to Approval and is used for Deploy as well as for the new TransactionV1 model.
  • ActionThresholds class has now new UpgradeManagement property.
  • The EntryPoint class has new entry point types and a new property EntryPointPayment. Both apply when working with Casper 2.0 only.
  • Step event from SSE contains a list of Transform objects instead of a ExecutionEffect instance.
  • FinalitySignature event contains BlockHeight and ChainNameHash value when connected to a Casper 2.0 node.
  • DeployProcessed event from SSE contains a ExecutionResultV1 object instead of a ExecutionResult object.

Deprecated

  • Proposer.isSystem property is marked as Obsolete. Use IsSystem with capital I instead.

Removed

  • GetAccountBalance() method in the RPC client has been removed. Use QueryBalance() instead. GetBalance() method exists to use state_get_balance from the RPC interface if needed.

Security

  • Upgraded the project to .NET 8 latest version to address CVE-2024-30105 vulnerability
  • BouncyCastle package updated to 2.4.0 version.
Assets 2
Loading