Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

FactomSharp .NET Factom node API DLL

A .NET implementation of the Factom API written in C#.

Supports:
  • factomd API V2
  • factom-walletd API V2

Features:

  • Provides all API functions. Native Json-like classes & helper methods.
  • Multi-node support, for automatic fallback.
  • Asyncronious Helper classes:
    • Chain class
      • Open/Create chain
      • Read/Write entries
      • IEnumerable entry lists
      • Track commit status, with callbacks.
    • FCT/EC class.
      • Track status, with callbacks. (TODO)
      • Track Balances (TODO)
  • HTTP, HTTPS, Proxy support (uses RestSharp)
  • NuGet for easy installation
Depends on:
  • Newtonsoft.json
  • RestSharp
  • dlech.Chaos.NaCL

To create a chain, and add some entries:
var factomd = new FactomdRestClient("https://api.mynode.com:8088"); 
var myEcAddress = "EC3PV61FYYEQFKwwCVEZj9m5Ge9TrPhE9A2N7pA9YPNM7PXNfuCh";
var myEsAddress = "Es4Mn6eW8AGtNhH1YSGepbBofFzfJnq3RLFtCZ93kZ14VwGaeQHq";

var address = new ECAddress(factomd,myEcAddress,myEsAddress);
using (var chain = new Chain(address))
{
  chain.ChainStatusChange += (o,a) => {
    Console.WriteLine($"ChainStatusChange: {a.ToString()}");
  };
        
  chain.QueueItemStatusChange += (o,a) => {
    var item = (EntryItem)o;
    Console.WriteLine($"EntryStatusChange {a.ToString()} {item?.ApiError?.error}");
  };

  chain.Create(Encoding.ASCII.GetBytes("This is my new chain"));

  for (int i =1; i< 10;i++)
  {
      var text = $"This is a test - hello! {i}";
      Console.WriteLine($"Writing: {text}");
      var entry = chain.AddEntry(Encoding.ASCII.GetBytes(text));
  }

  Console.ReadLine(); //Pause, let the chain thread run.
}  

The chain class will monitor the entries. The two status's of interest are:

TransactionACK   - Found in network, but not written to the blockchain yet.
DBlockConfirmed  - Found in Blockchain.
To read through the chain data:
var factomd = new FactomdRestClient("https://api.mynode.com:8088"); 
var myEcAddress = "EC3PV61FYYEQFKwwCVEZj9m5Ge9TrPhE9A2N7pA9YPNM7PXNfuCh";

var address = new ECAddress(factomd,myEcAddress);
using (var chain = new Chain(address,"3a6c770d8b152dcc80fa0a54fa931c6208e96f14f76dd616e51502a58836e9f8"))
{
   foreach (var item in chain.GetEntries())
   {
       WriteLine(Encoding.ASCII.GetString(item.Content));
   }
}

Full API support.

You will find all the API's in the namespace FactomSharp.Factomd.API and FactomSharp.FactomWalletd.API example:

var rate = new FactomSharp.Factomd.API.EntryCreditRate(factomd);
rate.Run();
WriteLine($"EC Rate {rate.Result.result.Rate}");
Multiple nodes:

Use a comma separated list of URLs:

https://api.mynode1.com:8088;https://api.mynode2.com:8088;https://api.mynode3.com:8088;

If a node fails to reply, or timeouts, the next node in the list is selected.

About

.NET DLL for Factom

Resources

License

Releases

No releases published

Packages

No packages published

Languages