ark net

为什么ARK.NET

ARK.NET是.NET平台的ARK生态系统库。它实现了所有最相关的方舟功能，以帮助您开发在方舟平台上构建的高效.NET应用程序。它还提供了低水平的方舟访问权限，因此您可以在其顶部轻松地构建应用程序。

包装支持：

• 具有完整的功能，Windows桌面应用程序，单声道桌面应用程序和.NET标准库支持的平台。使用框架> = 4.7.1和净标准2.0上的所有.NET解决方案。
• 异步/等待相应的同步方法。

如何安装？

与Nuget：

install-package ark.net在nuget网站上获取更多信息。

来自来源：

为了自己编译，您可以git克隆，打开项目并点击Visual Studio上的编译按钮。在命令提示中：

 git clone https://github.com/ArkEcosystem/ark-net
cd ark-net

如何开始？

所有ARK节点服务响应都有对象表示。您可以在服务文件夹下使用服务类。对于单个项目的列表或对象，响应是可以的。每种方法都有相应的异步方法。

最好让代码进行讲话。有关更多示例，请查看ARK.NET测试，其中所有测试均已编写，您可以看到API使用情况。某些代码片段在下面。

ARK.NET客户端初始化

需要开始第一个呼叫，因此库中的所有设置都可以在采取行动之前初始化。可以同时使用多个arknetapi实例（在同一应用程序中Devnet＆Mainnet）

 private ArkNetApi _arkNetApi ;
public ArkNetApi ArkNetApi
{
    get { return _arkNetApi ?? ( _arkNetApi = new ArkNetApi ( ) ) ; }
}
await ArkNetApi . Start ( NetworkType . MainNet ) ; //Other type is DevNet
//or
await ArkNetApi . Start ( specificPeerIp , specificPeerPort ) ;
//or (Multiple addresses)
await ArkNetApi . Start ( listArkPeerAddresses ) ;

帐户/钱包层

 //Existing account
var accCtnrl = new AccountController ( ArkNetApi , "top secret pass" ) ;

//Send ARK
var result = accCtnrl . SendArk ( 100 , "AUgTuukcKeE4XFdzaK6rEHMD5FLmVBSmHk" , "Akr.Net test trans from Account" ) ;

//Vote 4 Delegate                
var result = accCtnrl . VoteForDelegate ( delegateName ) ;

//Un-Vote Delegate                
var result = accCtnrl . UnVoteDelegate ( delegateName ) ;

//Create and send transaction.  Transaction can be saved offine (.ToJson()) and sent later.              
var transaction = accCtnrl . CreateTransaction ( 100 , "AUgTuukcKeE4XFdzaK6rEHMD5FLmVBSmHk" , "Akr.Net test trans from Account" ) ;
var result = accCtnrl . SendTransaction ( transaction ) ;

//Get Account
var account = accCtnrl . GetArkAccount ( ) ;

//New Account
new AccountController ( ArkNetApi , ArkNetApi . AccountService . GeneratePassphrase ( ) ) ;

服务层

有关可用API电话的完整列表，请查看ARK.NET测试项目

 //PeerService
var peers = ArkNetApi . PeerService . GetAll ( ) ;
var peersOK = peers . Where ( x => x . Status . Equals ( "OK" ) ) ;

//TransactionService
var trans = ArkNetApi . TransactionService . GetAll ( ) ;

//BlockService
var blocks = ArkNetApi . BlockService . GetAll ( ) ;

//AccountService - Generate passphrase
var result = ArkNetApi . AccountService . GeneratePassphrase ( ) ;

//DelegateService
var delegates = ArkNetApi . DelegateService . GetAll ( ) ;

//LoaderService
var autoConfigParams = ArkNetApi . LoaderService . GetAutoConfigureParameters ( ) ;
.. .

核心层

层用于核心方舟区块链通信（交易，加密...）。它由从服务和帐户层调用的API库包裹。

 //Create & send transaction
TransactionApi tx = ArkNetApi . TransactionApi . CreateTransaction ( recepient , amount , description , passphrase ) ;
Peer peer = ArkNetApi . NetworkApi . GetRandomPeer ( ) ;
var result = peer . PostTransaction ( tx ) ;

//Connect to a specific peer to perform requests
var peerApi = new PeerApi ( ArkNetApi , ipAddress , Port )
await peerApi . MakeRequest ( ArkStaticStrings . ArkHttpMethods . GET , ArkStaticStrings . ArkApiPaths . Loader . GET_STATUS ) ;

//Force specific peer.  All API calls will flow through this peer.  Set back to null to resume decentralized use.  Monitoring a specific peer is a use case for this functionality.
ArkNetApi . NetworkApi . ForcedPeer = ArkNetApi . PeerService . GetPeer ( ip , port ) ;
//or
ArkNetApi . NetworkApi . ForcedPeer = new PeerApi ( ArkNetApi , ipAddress , Port ) ;

// Switch network (Can also create new ArkNetApi instance as alternative solution)
await ArkNetApi . SwitchNetwork ( NetworkType . DevNet )

//New network
_arkNetApiDevNet = new ArkNetApi ( ) ;
await _arkNetApiDevNet . Start ( NetworkType . DevNet ) ;      

记录

任何记录框架都可以用来捕获arnknet内的日志。它由库的用户来实现iarklogger并将其传递给arknetapi.start（）。以下是使用log4net实现的示例。

 public class Log4netAdapter : IArkLogger
{
    private readonly ILog _log4NetLog ;

    public Log4netAdapter ( ILog log4NetLog )
    {
        _log4NetLog = log4NetLog ;
    }

    public void Log ( ArkLogEntry entry )
    {
        if ( entry . LogLevel == ArkLogLevel . Debug )
            _log4NetLog . Debug ( entry . Message , entry . Exception ) ;
        else if ( entry . LogLevel == ArkLogLevel . Info )
            _log4NetLog . Info ( entry . Message , entry . Exception ) ;
        else if ( entry . LogLevel == ArkLogLevel . Warn )
            _log4NetLog . Warn ( entry . Message , entry . Exception ) ;
        else if ( entry . LogLevel == ArkLogLevel . Error )
            _log4NetLog . Error ( entry . Message , entry . Exception ) ;
        else
            _log4NetLog . Fatal ( entry . Message , entry . Exception ) ;
    }
}

ILog log = LogManager . GetLogger ( typeof ( LoggingTests ) ) ;
await ArkNetApi . Start ( NetworkType . MainNet , new Log4netAdapter ( log ) ; 

取得联系

请使用GitHub问题进行问题或反馈。有关机密要求或特定要求，请通过我们的公共渠道与我们联系。

安全

如果您在此软件包中发现了安全漏洞，请发送电子邮件至[email protected]。所有安全漏洞将立即解决。

学分

• KristjanKošič
• Sharkdev-J
• 所有贡献者

执照

©Arkecosystem