-
Notifications
You must be signed in to change notification settings - Fork 26
Ditch.EOS
Easy interaction with EOS API.
.Net Standard allow to use Ditch.EOS in .NET Core, Mono, Xamarin(iOS/Mac/Android), Windows etc.
PM>
Install-Package Ditch.EOS
public class MyApp
{
protected RepeatHttpClient HttpClient; // Extended HttpClient (repeat request and async supported)
protected static OperationManager Api; // Main class to interaction with Ditch.EOS
public MyApp()
{
HttpClient = new RepeatHttpClient();
Api = new OperationManager(HttpClient)
{
ChainUrl = ConfigurationManager.AppSettings["ChainUrl"], // path to EOS node
WalletUrl = ConfigurationManager.AppSettings["WalletUrl"] // path to EOS Wallet (if needed)
};
}
...
}
Go to http://jungle.cryptolions.io/#account to create new test account or http://eosnetworkmonitor.io main net.
Go to http://jungle.cryptolions.io/#p2p to get url to node for "ChainUrl", for example http://dev.cryptolions.io:18888
Ditch.EOS is not a wallet! So you may:
- Use Ditch.EOS to signing transaction, but you need to pass WIF to library
- Use external Wallet for sighing transactions
Let`s adds login and WIF:
public string Login = "ditchtest";
public byte[] PrivateActiveWif = Base58.DecodePrivateWif("5HpybixN6DFwm13yovdsS26H6VbeTs3EXkynkPoV5zZ9vNpQiFZ");
Ditch.EOS support API:
- chain
- history
- wallet
var infoResp = await Api.GetInfo(CancellationToken.None);
Where infoResp is: Task<OperationResult>
OperationResult is wrapper. It`s contain:
- Result - responsed data (null if some exception was)
- Exception - some exception (null if all going well)
- RawRequest - Yours request for debug (if needed)
- RawResponse - responce for debug (may be empty)
Some endpoints needs arguments...
var args = new GetBlockParams
{
BlockNumOrId = infoResp.Result.LastIrreversibleBlockId
};
var blockResp = await Api.GetBlock(args, CancellationToken.None);
For example, get your tokens
var args = new GetTableRowsParams
{
Code = "eosio.token", // contract name (eosio.token is one of the main contracts, it`s probably already deployed on node)
Scope = "ditchtest", // scope... (Login)
Table = "accounts", // table name in the contract
Json = true, //if true - return data in json format, otherwise return binary (abi) data.
//LowerBound = "0",
//UpperBound = "-1",
//Limit = 10
};
var resp = await Api.GetTableRows(args, CancellationToken.None);
Actually, there are several steps needed to prepare and send transaction, but we will use facade function. For example let`s buy some ram:
var op = new BuyramAction
{
Account = User.Login,
Args = new Buyram
{
Payer = User.Login, // = WIF owner name
Receiver = User.Login,
Quant = new Asset("0.001 EOS")
},
Authorization = new[]
{
new PermissionLevel
{
Actor = User.Login, // WIF owner name
Permission = "active" // type of WIF needed/used for signing
}
}
};
* note ContractName = "eosio" and ActionName="buyram" already setted in BuyramAction constructor by default.
var resp = await Api.BroadcastActions(new[] { op }, new List<byte[]> { PrivateActiveKey }, CancellationToken.None);
If you have Wallet (EOS Wallet or Scatter) you may use another way to call function:
var resp = await Api.BroadcastActions(new[] { op }, new[] { new PublicKey(User.PublicActiveWif) }, SigningWithEosWallet, CancellationToken.None);
private async Task<OperationResult<SignedTransaction>> SigningWithEosWallet(SignedTransaction trx, PublicKey[] keys, string chainId, CancellationToken token)
{
await Api.WalletOpen(User.Login, token);
await Api.WalletUnlock(User.Login, User.Password, token);
var result = await Api.WalletSignTransaction(trx, keys, chainId, token);
await Api.WalletLock(User.Login, CancellationToken);
return result;
}
Ditch.EOS not support all existing contracts (it's just impossible) from the box. But there are a class ApiContractToModelGenerator which can generate all needed models.
var contractName = "eosio";
var @namespace = "MyProjectName";
var outDir = "//MyProjectName//Contracts//";
HashSet<string> actionFilter = new[] {"newaccount"}; // if null - then generate all actions
var generator = new ContractCodeGenerator();
await generator.Generate(Api, contractName, @namespace, outDir, actionFilter, CancellationToken.None);
In outDir will be added Eosio directory (= contract name). Include it in the project and rebuild. Then let`s call new action:
var op = new NewaccountAction
{
Account = User.Login,
Args = new Newaccount
{
... fill fields
},
Authorization = new[]
{
new PermissionLevel
{
Actor = User.Login,
Permission = "active"
}
}
}
var resp = await Api.BroadcastActions(new[] { op }, new List<byte[]> { PrivateActiveKey }, CancellationToken.None);
Enjoy :)