RFP-2: Agents - Libraries for secure integration with the IC

Question

RFP-2: Agents - Libraries for secure integration with the IC

domwoe opened this issue 2 years ago · comments

Overview

An IC (Internet Computer) Agent is responsible for encoding and decoding messages used to communicate with the IC via its HTTPS interface, as well as verifying responses from the IC by checking the signature against the public key of the IC.

DFINITY is maintaining two IC agent implementations which can be seen in a template:

agent-rs (Rust)
agent-js (JavaScript/TypeScript)

In addition, there are currently the following community-driven IC agent implementations with varying completeness:

icp-client-cpp (C++)
ic4j-agent (Java/Kotlin)
agent_dart (Dart/Flutter)
ic_dart_tools (Dart/Flutter)
agent-go (Go)
IC-Go (Go)
ic-py (Python)
ICP.NET (C#/.NET/Unity)
agent-unity (partial) C# wrapper of agent-rs))
ic_agent (Ruby)
ICPKit (Swift)

We are open to supporting work on existing agent implementations if features are missing, and we might support additional implementations for languages/frameworks that already exist if there is a good reason for this. In addition, the following agent implementations are desired:

Currently, there are active projects for all agents that have been requested. If you need another client library, please get in touch.

Requirements

Implementation of the HTTPS interface as defined in the IC Interface Specification. In particular, the following endpoints must be implemented: call, read_state, query and status.
Calculation of the request id using representation-independent hashing
Authentication: A request may be either anonymous or authenticated via signatures. For authenticated requests delegation should be supported.
CBOR: Requests and responses are CBOR encoded, hence, an IC agent needs to be able to encode/decode CBOR.
Candid: The IC uses Candid as the interface description language (IDL). An IC agent needs to be able to encode/decode arguments between candid and the agent's programming language.
Support of Principal data type.
IC certificate verification: Responses from the read_state API include a certificate that needs to be parsed (to look up the relevant information from the state tree) and verified. The public key of the IC must be hard coded in the software. For verification of responses from a local replica the public key needs to be fetched first.

Acceptance Criteria

Unit tests
E2E tests, e.g. using IC-Ref, See example in agent-rs.
Documentation
PR to Agents section on internetcomputer.org

References

icwizardmonke · Answer 1 · Wed Jul 05 2023 19:43:45 GMT+0800 (China Standard Time)

I found the Ruby agent.
I will tell you where it is if you give me collaborator status.

Dominic Wörner · Answer 2 · Wed Jul 05 2023 19:49:56 GMT+0800 (China Standard Time)

Hey @icwizardmonke,

we are aware of the Ruby agent (https://github.com/dfinity/awesome-internet-computer#ruby). There's no way to collaborate on a GitHub issue.

icwizardmonke · Answer 3 · Wed Jul 05 2023 23:15:26 GMT+0800 (China Standard Time)

Okay last time we spoke you didn't know where Ruby agent is

https://cdn.discordapp.com/attachments/1056016593261445122/1126168399911850135/Screenshot_2023-07-05-08-07-45-974.jpg

I saw a Dfinity tweet mention the Ruby Agent but had no link.
I replied asking for link. No response.
I replied again explaining I had searched the discord and asked you
https://cdn.discordapp.com/attachments/1056016593261445122/1126168858600943626/Screenshot_2023-07-05-08-12-26-254.jpg

No response.

On the relevant page, here in repo, there is no link to the Ruby Agent.

I could have simply added it through pull request.
Instead we have wasted time discussing here.

icwizardmonke · Answer 4 · Wed Jul 05 2023 23:21:17 GMT+0800 (China Standard Time)

If I am unable to be commit code and gain Contributor status, why would I participate in project?

Edit: I just got caught up in the Discord. I see external contributions will be allowed soon. Thank you.

Dominic Wörner · Answer 5 · Wed Jul 05 2023 23:40:31 GMT+0800 (China Standard Time)

I came across the repo for the Ruby agent only after our discussion, and I couldn't find our discussion anymore, because I just have too many Discord chats (I tried). Hence, I only added it to https://github.com/dfinity/awesome-internet-computer (btw this repo accepts external contributions).

As mentioned in my first comment, Github doesn't allow PRs/contributions to issues.

Dominic Wörner · Answer 6 · Mon Jul 10 2023 16:21:56 GMT+0800 (China Standard Time)

@icwizardmonke FYI, this repo should be ready to accept external contributions now.

Ivan Gromakovskii · Answer 7 · Thu Aug 24 2023 22:22:22 GMT+0800 (China Standard Time)

We are open to supporting work on existing agent implementations if features are missing, and we might support additional implementations for languages/frameworks that already exist if there is a good reason for this.

Are you open to supporting work on new agent implementations in programming languages that don't have them? E. g. Haskell.

Dominic Wörner · Answer 8 · Fri Aug 25 2023 19:17:37 GMT+0800 (China Standard Time)

Hi @gromakovsky,

yes, we are! The main ones we'd be interested in are a swift agent and driving the C++ for multiplatform Unreal Engine Development.

Edit: If you are only interested in Haskell, I think the more interesting project would be a Haskel Canister Development Kit.