Asset canister source code?

nomeata · August 12, 2021, 9:42am

I was just helping someone trying to build an interesting app for the Internet Computer, and they would benefit from having a dedicated asset storing and serving canister – and dfx ships with such a canister! But it seems that the code itself isn’t available yet.

Can we expect that canister code to be publicly available soon, or should I advise them to work without it, @roman-kashitsyn?

roman-kashitsyn · August 12, 2021, 2:19pm

Hi @nomeata!

The assets canister is in the final stages of the open-sourcing pipeline, it should be open very soon (I hope within a week or so). I’m looking forward to finally making it public. People should be able to see the code that serves their assets.

nomeata · August 13, 2021, 10:18am

Related to that, the specification for our simple certified HTTP asset protocol deserves a public home. Maybe include it in the repo, until it has a better one?

In fact, the whole HTTP Gateway feature specification needs a home…

paulyoung · August 14, 2021, 3:29am

@nomeata does the HTTP Gateway feature specification apply to this PR?

github.com/dfinity/agent-rs

feat: upgrade HTTP request calls from query to update upon canister's request

dfinity:main ← paulyoung:paulyoung/http-request

opened 01:45AM - 28 May 21 UTC

paulyoung

+203 -21

This is a first pass at inferring when to make an update call instead of a query… call based on HTTP request methods. It's based on [this discussion thread](https://forum.dfinity.org/t/feature-request-map-appropriate-http-request-methods-to-update-calls/4303?u=paulyoung) in the developer forum. Thanks to @nomeata for some feedback and help getting to this point. I think this could be made a lot more configurable (perhaps via a file that is read when `icx-proxy` starts which maps methods/routes to functions) but what's here suits my needs for now so I thought I'd share it in case there's any interest in merging. Thanks in advance for considering this change. *** ```typescript import Text "mo:base/Text"; actor { type HeaderField = (Text, Text); type Token = {}; type StreamingCallbackHttpResponse = { body : Blob; token : Token; }; type StreamingStrategy = { #Callback : { callback : shared Token -> async StreamingCallbackHttpResponse; token : Token; }; }; type HttpRequest = { method : Text; url : Text; headers : [HeaderField]; body : Blob; }; type HttpResponse = { status_code : Nat16; headers : [HeaderField]; body : Blob; streaming_strategy : ?StreamingStrategy; }; public query func http_request(request : HttpRequest) : async HttpResponse { { status_code = 200; headers = []; body = Text.encodeUtf8("Response to " # request.method # " request (query)"); streaming_strategy = null; }; }; public shared func http_request_update(request : HttpRequest) : async HttpResponse { { status_code = 200; headers = []; body = Text.encodeUtf8("Response to " # request.method # " request (update)"); streaming_strategy = null; }; }; }; ``` ``` $ icx-proxy --fetch-root-key version: 0.2.1 May 27 18:24:15.771 INFO Log Level: INFO May 27 18:24:15.797 INFO Starting server. Listening on http://127.0.0.1:3000/ ``` ``` $ curl -v -X GET -H "Content-type: application/json" -H "Accept: application/json" -d '{}' 'http://localhost:3000?canisterId=rrkah-fqaaa-aaaaa-aaaaq-cai' * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 3000 (#0) > GET /?canisterId=rrkah-fqaaa-aaaaa-aaaaq-cai HTTP/1.1 > Host: localhost:3000 > User-Agent: curl/7.64.1 > Content-type: application/json > Accept: application/json > Content-Length: 61 > * upload completely sent off: 61 out of 61 bytes < HTTP/1.1 200 OK < content-length: 31 < date: Fri, 28 May 2021 01:27:24 GMT < * Connection #0 to host localhost left intact Response to GET request (query)* Closing connection 0 ``` ``` $ curl -v -X POST -H "Content-type: application/json" -H "Accept: application/json" -d '{}' 'http://localhost:3000?canisterId=rrkah-fqaaa-aaaaa-aaaaq-cai' Note: Unnecessary use of -X or --request, POST is already inferred. * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 3000 (#0) > POST /?canisterId=rrkah-fqaaa-aaaaa-aaaaq-cai HTTP/1.1 > Host: localhost:3000 > User-Agent: curl/7.64.1 > Content-type: application/json > Accept: application/json > Content-Length: 61 > * upload completely sent off: 61 out of 61 bytes < HTTP/1.1 200 OK < content-length: 33 < date: Fri, 28 May 2021 01:27:41 GMT < * Connection #0 to host localhost left intact Response to POST request (update)* Closing connection 0 ```

nomeata · August 14, 2021, 6:29pm

Right, that specification would have to be changed (extended) for that feature. So having the spec in a public place where proposals can be made would be even better

roman-kashitsyn · August 25, 2021, 3:07pm

I’ve just got the final approval and pressed the button.
It’s public now: GitHub - dfinity/certified-assets: A certified assets canister written in Rust.

heyuanxun · February 12, 2022, 8:36am

is this have motoko code?

roman-kashitsyn · February 12, 2022, 8:56am

is this have motoko code?

The assets canister that ships with DFX is written in Rust.
We designed it to be backward-compatible with the first version of the asset canister that was written in Motoko.

The Motoko version was retired in this PR: https://github.com/dfinity/sdk/pull/1644.

icme · October 8, 2022, 11:39pm

This repo now points me to sdk/src/canisters/frontend/ic-frontend-canister at master · dfinity/sdk · GitHub, which doesn’t have the source code implementation.

Looking at crates.io: Rust Package Registry points me to GitHub - dfinity/cdk-rs: Rust canister development kit for the Internet Computer., and I’m assuming the assets canister is somewhere in https://github.com/dfinity/cdk-rs/tree/main/library/ic-certified-map?

Note that this half-hearted struggle in trying to find the current Asset Canister source code is coming from someone with no experience in Rust other than hello world, but I’m curious since @sea-snake just made some improvements to agent-js, adding an AssetManager to the 0.14.0 release.

paulyoung · October 9, 2022, 12:12am

@icme i think you might be looking for sdk/src/canisters/frontend/ic-certified-assets at master · dfinity/sdk · GitHub

icme · October 9, 2022, 6:28pm

See it now, thanks

anon74414410 · October 10, 2022, 4:32pm

Yeah, sorry about that - we decided to consolidate recently because it was confusing to find all the packages. We should make sure that we leave some breadcrumb readme’s behind so people know where to go

Topic		Replies	Views
Question on http_request() Developers	17	3275	August 28, 2021
Can we somehow achieve or build a canister with a interface bahaving like a classic web server Developers	53	14965	May 25, 2021
Exposing URLs for querying images Developers	20	2103	May 16, 2022
Assigned: BNT-13 - Motoko Certified Assets Canister Bounties & RFPs	19	1191	July 7, 2025
IC management create canister type "asset" Developers	15	3101	June 21, 2022

Asset canister source code?

Related topics