proximax-storage / csharp-xpx-chain-sdk

ProximaX Sirius-Chain C# SDK

ProximaX Sirius Blockchain C# SDK

Official ProximaX Sirius Blockchain SDK Library in C#.

The ProximaX Sirius Catapult Chain C# SDK is a C# library for interacting with the Sirius Blockchain. It provides a complete library set coverage, and supports synchronous and asynchronous requests.

Requirements

.NetStandard 2.0

See !here for platform compatibility

Installation

In .Net Core

dotnet add package csharp-xpx-chain-sdk

dotnet restore

If you are using legacy .Net Framework 4.6.1 and above

Install-Package csharp-xpx-chain-sdk

Wiki and Examples

For SDK documentation and examples see wiki

Contribution

We'd love to get more people involved in the project. Please feel free to raise issue or PR and we'll review your contribution.

License

Project is licensed under Apache License Version 2.0. See LICENSE file for details.

_{Copyright (c) 2019 ProximaX Limited}

csharp-xpx-chain-sdk's Issues

Bug: Unable to send transaction with decimal places

Unable to send transactions with decimal places

var mosaicToTransfer = NetworkCurrencyMosaic.CreateRelative(amount);

amount = ulong, so not able to send 1.5xpx

Support versioning

new server supports versioning and there were changes in serialization amongst other things. implement support for this new server

Anatoliy Osetsymskyi
Hi guys=) We did Versinoning release of blockchain(It is next release for Dragon. We don't plan to integrate Elephant and next NEM releases at the moment, but maybe we will change it in future).
It contains breaking changes, so now sdk doesn't work with it. But you can easy fix it.

We increased the version(it is field in transaction) of each transaction from 2 bytes(uint16) to 4 bytes(uint32).
Also we added CatapultConfigTransaction and CatapultUpgradeTransaction.

You can find updated flatbuffers here:
https://github.com/proximax-storage/go-xpx-chain-sdk/tree/development/transactions/schemas

Also we added "config/{height}" and "upgrade/{height}" routes. First route returns config of network at height X, second return required version of blockchain
You can find more information in swagger:
https://github.com/proximax-storage/js-xpx-chain-rest/blob/master/swagger.yaml

If you have questions, you can check GO SDK first(For example how to create a new version of tranasction, or how to parse blockchain's config):
https://github.com/proximax-storage/go-xpx-chain-sdk/pull/46/files

Also we removed hardcoded currency MosaicId=) Now it is namespaceId "prx.xpx", because each network will have own MosaicId:
https://github.com/proximax-storage/go-xpx-chain-sdk/blob/development/sdk/consts.go#L15

For testing you can use local version of blockchain or devnet. On the next week we will push it to staging network:
Local(currency mosaic is prx.xpx): https://github.com/proximax-storage/dfms-dev-net/releases/tag/versioning-0.1
Devnet(currency mosaic is prx.xpx): http://bcdev1.xpxsirius.io:3000/config/1

Shin Neng Wong
latest update for testnet:
COW version:
bctestnet1.xpxsirius.io
bctestnet2.xpxsirius.io

*DRAGON version :
bctestnet1-dragon.xpxsirius.io
bctestnet2-dragon.xpxsirius.io
bctestnet3-dragon.xpxsirius.io
bctestnet4-dragon.xpxsirius.io
bctestnet5-dragon.xpxsirius.io
bctestnet6-dragon.xpxsirius.io

chain will be reset once new Dragon version is ready

Feature: add GetMosaicName(mosaicId) to MosaicHttp

Add GetMosaicName(mosaicId) to MosaicHttp to retreive information of one Mosaic