EdjCase.ICP.Agent 0.0.1-beta.2

This is a prerelease version of EdjCase.ICP.Agent.
There is a newer version of this package available.
See the version list below for details.
dotnet add package EdjCase.ICP.Agent --version 0.0.1-beta.2                
NuGet\Install-Package EdjCase.ICP.Agent -Version 0.0.1-beta.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="EdjCase.ICP.Agent" Version="0.0.1-beta.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add EdjCase.ICP.Agent --version 0.0.1-beta.2                
#r "nuget: EdjCase.ICP.Agent, 0.0.1-beta.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install EdjCase.ICP.Agent as a Cake Addin
#addin nuget:?package=EdjCase.ICP.Agent&version=0.0.1-beta.2&prerelease

// Install EdjCase.ICP.Agent as a Cake Tool
#tool nuget:?package=EdjCase.ICP.Agent&version=0.0.1-beta.2&prerelease                

ICP.NET

Collection of Internet Computer Protocol (ICP) libraries for .NET/Blazor

  • Agent - Library to allow communication to and from the Internet Computer

  • Candid - Library of Candid Encoding, Models and Helpers to work with

  • Samples - A few projects to demo the capabilities of the ICP libraries

Roadmap/TODO

  • Serialization for custom C# models
  • Automatic Api Client/Model generation from Candid spec
  • Infer type from value, vs specifying value + type

Agent

Usage

// Create identity
var identity = new AnonymousIdentity();

// Create http agent
IAgent agent = new HttpAgent(identity);

// Create Candid arg to send in request
CandidArg arg = CandidArg.FromCandid(
    CandidValueWithType.FromValueAndType( // WIP, will reduce redundancy
        CandidPrimitive.Nat64(1234),
        new PrimitiveCandidTypeDefinition(CandidPrimitiveType.Nat64)
    )
);

// Make request to IC
string method = "get_proposal_info";
Principal governanceCanisterId = Principal.FromText("rrkah-fqaaa-aaaaa-aaaaq-cai");
QueryResponse response = await agent.QueryAsync(governanceCanisterId, method, arg);

QueryReply reply = response.ThrowOrGetReply();

CandidArg responseArg = reply.Arg;
// Use response ...

Candid

Usage

Parsing bytes

CandidArg arg = CandidArg.FromBytes(rawCandidBytes);

Using candid values directly

CandidArg arg = CandidArg.FromBytes(rawCandidBytes);
CandidValue firstArg = arg.Values[0];
string title = firstArg.AsRecord()["title"];

Converting candid to custom classes (custom serialization is on the roadmap)

CandidArg arg = CandidArg.FromBytes(rawCandidBytes);
MyObj obj = arg.Values[0].Value.AsRecord(r => new MyObj
{
    Title = r["title"].AsText(),
    IsGoodTitle = r["is_good_title"].AsBool()
});

public class MyObj
{
    public string Title { get; set; }
    public bool IsGoodTitle { get; set; }
}
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on EdjCase.ICP.Agent:

Package Downloads
EdjCase.ICP.InternetIdentity

Package Description

EdjCase.ICP.WebSockets

Package Description

EdjCase.ICP.PocketIC

Package Description

Qwer.Chains.Dfinity.Clients

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
7.0.0 44 1/15/2025
7.0.0-rc.1 82 1/4/2025
7.0.0-pre.1 258 10/27/2024
6.2.1 182 10/23/2024
6.2.0 150 10/21/2024
6.1.2 1,643 4/30/2024
6.1.1 166 4/17/2024
6.1.0 161 4/15/2024
6.0.0 188 3/21/2024
5.1.0 269 1/25/2024
5.0.0 1,203 1/12/2024
5.0.0-pre.2 126 12/13/2023
5.0.0-pre.1 88 12/11/2023
4.1.0 470 11/10/2023
4.0.1 256 11/1/2023
4.0.0 380 10/12/2023
4.0.0-pre.10 89 10/10/2023
4.0.0-pre.9 86 10/10/2023
4.0.0-pre.8 81 10/9/2023
4.0.0-pre.7 85 10/9/2023
4.0.0-pre.6 81 10/9/2023
4.0.0-pre.5 89 10/8/2023
4.0.0-pre.4 89 10/6/2023
4.0.0-pre.3 88 10/5/2023
4.0.0-pre.2 86 9/27/2023
4.0.0-pre.1 86 9/25/2023
3.2.2 493 9/22/2023
3.2.1 187 9/22/2023
3.2.0 689 8/2/2023
3.1.5 202 9/27/2023
3.1.4 305 7/20/2023
3.1.3 395 6/12/2023
3.1.2 478 5/11/2023
3.1.1 263 5/9/2023
3.1.0 249 5/9/2023
3.0.1 263 5/2/2023
3.0.0 275 5/1/2023
3.0.0-beta.1 130 4/17/2023
2.3.9 248 5/1/2023
2.3.8 277 4/28/2023
2.3.7 289 4/28/2023
2.3.6 296 4/28/2023
2.3.5 305 4/27/2023
2.3.4 283 4/27/2023
2.3.3 328 4/26/2023
2.3.2 303 4/26/2023
2.3.1 364 4/26/2023
2.3.0 313 4/25/2023
2.2.10 317 4/24/2023
2.2.9 280 4/24/2023
2.2.8 335 4/24/2023
2.2.7 380 4/17/2023
2.2.6 421 4/12/2023
2.2.5 314 4/12/2023
2.2.4 351 4/11/2023
2.2.3 340 4/11/2023
2.2.2 356 4/7/2023
2.2.1 311 4/7/2023
2.2.0 369 4/6/2023
2.1.1 425 3/30/2023
2.1.0 546 3/23/2023
2.0.8 432 3/20/2023
2.0.7 497 3/12/2023
2.0.2 428 3/10/2023
2.0.1 409 3/10/2023
2.0.0 426 3/8/2023
2.0.0-beta.26 122 3/8/2023
2.0.0-beta.25 128 3/8/2023
2.0.0-beta.24 134 3/7/2023
2.0.0-beta.23 131 3/6/2023
2.0.0-beta.22 128 3/1/2023
2.0.0-beta.21 145 2/28/2023
2.0.0-beta.20 132 2/20/2023
2.0.0-beta.19 136 2/14/2023
2.0.0-beta.18 134 2/14/2023
2.0.0-beta.17 127 2/14/2023
2.0.0-beta.16 129 2/11/2023
2.0.0-beta.15 131 2/10/2023
2.0.0-beta.14 142 2/6/2023
2.0.0-beta.13 154 2/3/2023
2.0.0-beta.12 148 2/2/2023
2.0.0-beta.11 147 1/30/2023
2.0.0-beta.10 143 1/23/2023
2.0.0-beta.9 153 1/19/2023
2.0.0-beta.8 151 1/19/2023
2.0.0-beta.7 149 1/12/2023
2.0.0-beta.6 150 12/31/2022
2.0.0-beta.5 141 12/30/2022
2.0.0-beta.4 145 12/21/2022
2.0.0-beta.3 148 12/19/2022
2.0.0-beta.2 148 12/10/2022
2.0.0-beta.1 151 12/2/2022
1.2.1 471 11/29/2022
1.2.0 436 11/28/2022
1.1.0 455 11/28/2022
1.0.3 433 11/25/2022
1.0.2 542 6/8/2022
1.0.1 545 6/7/2022
0.0.1-beta.20 166 6/1/2022
0.0.1-beta.19 170 5/20/2022
0.0.1-beta.18 171 5/20/2022
0.0.1-beta.14 169 5/19/2022
0.0.1-beta.13 171 5/18/2022
0.0.1-beta.3 194 5/16/2022
0.0.1-beta.2 192 5/11/2022
0.0.1-beta.1 164 5/11/2022