Description

To build a candid builder for agent dart

Context

Candid is used to describe IDL for canister functions. Candid builder is used to transform candid files to usable functions/classes for agent clients in different languages. For dart language, all interfaces are classes. To make a workable builder, like we do json decoding classes, candid builder should also transform all those interfaces into classes.

Candid files are trans-compiled into typescript and javascript using didc, link is here

There are repos maintained by community for other languages:

1. Kotlin
2. Haskell
3. AssemblyScript
4. elm

Since agent_dart is ported agains agent-js, all IDL interfaces and styles are very similar to javascript/typescript.

for example , in generarted javascript:

const Purpose = IDL.Variant({
    'authentication' : IDL.Null,
    'recovery' : IDL.Null,
});
const CredentialId = IDL.Vec(IDL.Nat8);

in agent_dart, we can almost simply copy paste

final Purpose = IDL.Variant({
    'authentication' : IDL.Null,
    'recovery' : IDL.Null,
});
final CredentialId = IDL.Vec(IDL.Nat8);

So we might be able to :

1. modify and use didc to generate those idl,
2. THEN write classes using dart builder

To see working classes in dart, please refer to wallet/ledger.dart

Acceptance Criteria

• [ ] modify and combine didc to builder to generate idls
• [ ] use dart builder to generate artifacts in dart classes
• [ ] tests and working examples, published to other repo.

Reward

30 ICPs

This is the error that I am getting while creating an actor

ArgumentError: Invalid argument(s): Failed to lookup symbol 'bls_verify': dlsym(RTLD_DEFAULT, bls_verify): symbol not found

Full Stack Trace:

ArgumentError: Invalid argument(s): Failed to lookup symbol 'bls_verify': dlsym(RTLD_DEFAULT, bls_verify): symbol not found
  File "ffi_dynamic_library_patch.dart", line 34, in DynamicLibrary.lookup
  File "ffi_base.dart", line 23, in rustBlsVerify
  File "bls.ffi.dart", in FFIBls.blsVerifySync
  File "certificate.dart", line 155, in Certificate.verify
  File "<asynchronous suspension>"
  File "certificate.dart", line 179, in Certificate._checkDelegation
  File "<asynchronous suspension>"
  File "certificate.dart", line 149, in Certificate.verify
  File "<asynchronous suspension>"
  File "index.dart", line 17, in pollForResponse
  File "<asynchronous suspension>"
  File "actor.dart", line 432, in _createActorMethod.<fn>

If it helps, my app communicates with a dozen dynamic canisters and creates dozen of actors using this common method

  Future<CanisterActor> getVideoCanisterActor(String canisterId) async {
    if (_canisters[canisterId] == null) {
      AgentFactory _videoCanisterAgent = await AgentFactory.createAgent(
        canisterId: canisterId,
        url: backendUrl,
        idl: videoCanisterIDL,
      );
      _canisters[canisterId] = _videoCanisterAgent.actor!;
    }
    return _canisters[canisterId]!;
  }

Hello,

When I try to use IC identity (using local page), I got a normal identity, and the result is like in the example project in this lib. After that, I am calling the IC canister, and I got an error. Error: Unhandled Exception: Unhandled error Server returned an error: Code: 403 (Forbidden)

Body: Failed to authenticate request 0x5f5b53a270e40c4558549975f54c17163b24b337054255bc1c2e56705fab9860 due to: Invalid delegation: Invalid canister signature: IcCanisterSignature signature could not be verified: public key 0a000000000000000701012ad6fa197bcc32c16f588d58ccb0468c9bd039c9b60302ad08e03cda98f6243f, signature d9d9f7a26b63657a9.......678301820458200e729de08c6bfa677847fb8d7bcc79efc892045aed2c4b350f7c7446085257f5830182045820b71837514f52507ff04caee7b05a920f1d5ac8863b9d65d3489951ff33b1187e83025820f487586c5bdaaa19d6f10abc3626e44af4624a386c64832659da432f265a61f5830258208b8ee0cf244a56d1b8fa863141be1b473f9e0576d941282124d41e2b44793519820340, error: the signature tree doesn't contain sig/f487586c5bdaaa19d6f10abc3626e44af4624a386c64832659da432f265a61f5/2baf862838777c8dfc951a5b4b3768b5ce23bc641ea0a1172f3e0726de7ae936

I don't have any problem with normal identity (created by myself), but this Delegation one made this error.

Do you have some idea how to solve this problem?

I'm encountering this error when calling fetchRootKey() of HttpAgent in _initAgent():

E/flutter (23155): [ERROR:flutter/lib/ui/ui_dart_state.cc(199)] Unhandled Exception: http request failed because SocketException: OS Error: Connection refused, errno = 111, address = localhost, port = 46950 E/flutter (23155): #0 HttpAgent._defaultFetch (package:agent_dart/agent/agent/http/index.dart:433:7) E/flutter (23155): E/flutter (23155): #1 HttpAgent.status (package:agent_dart/agent/agent/http/index.dart:362:20) E/flutter (23155): E/flutter (23155): #2 HttpAgent.fetchRootKey (package:agent_dart/agent/agent/http/index.dart:246:20) E/flutter (23155): E/flutter (23155): #3 AgentFactory._initAgent (package:agent_dart_example/init.dart:63:7) E/flutter (23155): E/flutter (23155):

This means that the port somehow gets changed since I specified port 40161 in the url of the AgentFactory (this is where my local replica runs). I also tried to directly set the port with the host parameter of HttpAgentOptions but still get the same error.

Am I missing something?

agent_dart Branch: 1.0.0-dev
Commit: 0b39334b70a30f593d0bc6c8f744ac9300659faf

Stack Trace:

_Exception: Exception: Subclasses of `FlutterRustBridgeBase` should be singletons - there should not be two instances (runtimeType=AgentDartImpl)
  File "basic.dart", line 28, in FlutterRustBridgeBase._sanityCheckSingleton
  File "basic.dart", line 19, in new FlutterRustBridgeBase
  File "ffi_bridge.dart", line 314, in new AgentDartImpl.raw
  File "ffi_bridge.dart", line 312, in new AgentDartImpl
  File "ffi_helper.dart", line 40, in new AgentDartFFI._
  File "ffi_helper.dart", line 50, in AgentDartFFI._instance
  File "ed25519.dart", in Ed25519KeyIdentity.generate
  File "auth_client.dart", line 212, in AuthClient.login
  File "login.dart", line 61, in _LoginScreenState._loginUsingII

The exact function that caused the issue is Ed25519KeyIdentity.generate from AuthClient package.

I want to send icp to account: 1586275a55430abba47862989da56f2c9ac31bc9f1c58739d6637a33714f307a Here is my code: var mne ='xxx'; var p = RosettaApi(); var key = fromMnemonicWithoutValidation(mne, []); await p.init(); var pre = await p.transferPreCombine( key.getPublicKey().toRaw(), hex.HEX.decode( '1586275a55430abba47862989da56f2c9ac31bc9f1c58739d6637a33714f307a'), BigInt.from(90000), BigInt.from(10000), {}); var s = await transferCombine(key, pre); var res = await p.transfer_post_combine(s); print(res);

But when I run code above, I get some error. Could you please give me a code example, thanks.

• Improve all import/export sorts.
• Add @immutable as much as possible.
• Better construct for RosettaTransaction and RecClass.
• Make PrimitiveType's constructor private.
• Constraint Android API support range to 23~32.

Error

1 │ application/cbor, application/cbor

Description:

While execute with update and query call using flutter web, the IC behaves differently between Native and Web, which is on the Web, IC (mainnet) may return dual headers to the client, somehow it's However, agent_dart using flutter/dart's official http package to make the requests internally. Although the Response class from Http returns normally, however, while using Response.body to get a string( in order to display non-bytes error or message), the MediaType.parse function will throw error since it only supports single type Media type.

Fix: To set Response.headers manually ,only accept the first content-type and discard the rest, before getting the body string.

https://github.com/AstroxNetwork/agent_dart/blob/f6f41e842999a710da9f4f20dfcdaea1bc2e0904/lib/agent/agent/http/fetch.dart#L73

Update: Try this branch https://github.com/AstroxNetwork/agent_dart/tree/feat/web

Worth trying for further experiment: https://github.com/EPNW/web_ffi

TODO:

• ~~Migrate bls_init & bls_verify to WASM built for Flutter Web~~
• ~~Other possible compatible problem~~

Thinking about the keystore file format compatible to ethereum's system, however is not so efficiency. But it still worth finding a replacement to the format.

In dart, to implement the keystore encode/decode, one has to combine the scrypt and pbkdf2 to it. The easiest way to complete the job is to borrow the code from web3dart or laksadart I previously built for Zilliqa. However the encoding speed is too slow because of scrypt algorithm is slow.

Another option is to use FFI from other native library like ethsign , it is fast and run smoothly when I tried to bind it to the dynamic library. However, in rust we generally use serde_json to encode the Crypto object, the serde_json will be binded too, which will largely increase the bundle's size.

I don't have enough time to do enough search to finish the task. So if you have idea or solution, please comment or reply.

1. A replacement standard or format for keystore.
2. A fast and efficient way to encode/decode using FFI or pure dart code.
3. Any other good ideas

added CurveType to Signer.importPhrase and related area

• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L252-L255
• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L196-L197
• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L182-L186
• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L179
• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L82-L83
• https://github.com/AstroxNetwork/agent_dart/blob/e8737627911b0ac24460ecfc71378bd0322e64e8/lib/wallet/signer.dart#L51-L55

Right now the project has a dependency on flutter thus it's not possible to use the package on a pure dart environment like a server-side dart.

Package behaves more like agent_flutter rather than agent_dart.

Feel free to submit your projects here, and we will move them to README, and later to doc site

Template below:

• Project Name

My very cool project

• Project Type

Defi DApp/Wallet/Metaverse/Social DApps/Open Service/Tooling....

• Description

Your project description

• Official Website

If available

• Download Link/Market URI

If available, Google Play/ Apple AppStore/ other URL

Description

Documentation for agent_dart apis

Context

To have better understanding of internet computer, for client developers, it is the best way to understand how the sdk works.

Though we have ported most agent-js features to agent_dart, we don't have enough resources to complete the api docs. Which is really important work for community developers.

Thus, we need to cover as many apis as possible, we need someone to comment on code like we do for dart code.

Acceptance Criteria

• [ ] [comment on code to cover all apis]
• [ ] [generate dart docs]
• [ ] [optional generate gitbook or github pages]
• [ ] [optional tutorial/docs site for developers]

Reward

[20 ICPs, with 10 ICPs bonus for docs site]