Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

0.1.2 3 #41

Merged
merged 4 commits into from
Feb 17, 2023
Merged

0.1.2 3 #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
6f4716a
Adding DIP721 Functions
skilesare Feb 16, 2023
3b9e2ea
dip721_get_metadata
skilesare Feb 16, 2023
b671083
fix metadata
skilesare Feb 17, 2023
1b08159
Doc updates
skilesare Feb 17, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/release_notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,12 @@ Token-id - Each token in your collection has a unique text-based namespace id.

Library-id - Each library item in your token's asset library has a unique text-based namespace id.

v0.1.2-3

* DIP721 - Added v2 functions that seem to be supported by plug
* EXT and DIP721 - Added endpoint at /collection/translate and /-/{token_id}/translate to retrieve ext and dip721 token id mappings.
* Collection Info - added created_at, upgrade_at_unique_holder count, and transaction_count

v0.1.2-2

* Adds gateway principal to the storage_info_nft_origyn query
Expand Down
46 changes: 34 additions & 12 deletions docs/specification.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,10 @@ type BalanceResult = {

* alternative mappings
* query balanceOfDip721(user: principal) -> Nat64; - only supports principals
* query balanceOf(user: principal) -> Nat64; - only supports principals - dip721 legacy
* query dip721_balanceOf(user: principal) -> Nat64; - only supports principals - dip721 v2
* query balanceEXT(request: EXTBalanceRequest) -> EXTBalanceResponse; Token Identifier is a text from Principal of [10, 116, 105, 100] + CanisterID as [Nat8] + Nat32 as bytes of Text.hash of token_id as each canister has only one token identifier
* query balance(request: EXTBalanceRequest) -> EXTBalanceResponse; Token Identifier is a text from Principal of [10, 116, 105, 100] + CanisterID as [Nat8] + Nat32 as bytes of Text.hash of token_id as each canister has only one token identifier

## Owner

Expand All @@ -43,7 +46,8 @@ Returns the owner of the NFT indicated by token_id.

* Alternative mappings
* query ownerOfDip721(token_id: Nat) -> DIP721OwnerResult; - will compare Nat64 hash of text token IDs to the token_id
* query ownerOf(token_id: Nat) -> DIP721OwnerResult; - will compare Nat64 hash of text token IDs to the token_id //for questionable "v2" upgrade where the standard is now compatable with fewer web 3 tools
* query ownerOf(token_id: Nat) -> DIP721OwnerResult; - will compare Nat64 hash of text token IDs to the token_id //legacy
* query dip721_ownerOf(token_id: Nat) -> DIP721OwnerResult; - will compare Nat64 hash of text token IDs to the token_id //for questionable "v2" upgrade where the standard is now compatable with fewer web 3 tools
* query bearerEXT(token: TokenIdentifier) -> Result<EXTAccountIdentifier, EXTCommonError>; bearer() also exists for legacy native ext support
* query bearer(token: TokenIdentifier) -> Result<EXTAccountIdentifier, EXTCommonError>; bearer() also exists for legacy native ext support //for legacy support

Expand Down Expand Up @@ -175,7 +179,9 @@ Note: For alternative mappings the existence of an escrow is the approval for th
* alternative mappings
* transferFromDip721(from: principal, to: principal, tokenAsNat: nat) -> Result; - token_id will be converted from the Nat representation.
* transferFrom(from: principal, to: principal, tokenAsNat: nat) -> Result; - token_id will be converted from the Nat representation. //v2
* dip721_transferFrom(from: principal, to: principal, tokenAsNat: nat) -> Result; - token_id will be converted from the Nat representation. //v2
* transferDip721(to: principal, tokenAsNat: nat) -> Result; - token_id will be converted from the Nat representation.
* dip721_transfer(to: principal, tokenAsNat: nat) -> Result; - token_id will be converted from the Nat representation.
* transferEXT(request : EXTTransferRequest) -> EXTTransferResponse; transfer() also exists for legacy native ext support
* transfer(request : EXTTransferRequest) -> EXTTransferResponse; transfer() also exists for legacy native ext support

Expand Down Expand Up @@ -410,6 +416,12 @@ owner - required - principal - the owner of the NFT.

is_soulbound - optional - #Bool(true) if you don't want the NFT to change owners


##### Alternative mappings

* dip721_token_metadata(token_id : Nat) : async DIP721.Metadata_3 query; //token metadata for dip721
* tokenMetadata(token_id : Nat) : async DIP721.Metadata_3 query; //token metadata for dip721

#### Collection Level Metadata

com.origyn.node - suggested - Node that endorses and authenticates NFTs minted from this collection - used for paying node royalties
Expand Down Expand Up @@ -470,8 +482,14 @@ com.origyn.royalties.secondary.default - Array(frozen) - List of Classes of rate
```

* alternative mappings
* getMetaDataDip721() -> DIP721MetadataResult query //nyi
* metadata() -> DIP721MetadataResult query //metadata for plug
* dip721_metadata() -> DIP721MetadataResult query //metadata for plug
* dip721_owner_token_metadata(owner : Principal) : async DIP721.Metadata_2 query; //gets owner token info
* ownerTokenMetadata(owner : Principal) : async DIP721.Metadata_2 //gets owner token info
* dip721_operator_token_metadata(owner : Principal) : async DIP721.Metadata_2 query; //gets owner token info
* operatorTokenMetadata(owner : Principal) : async DIP721.Metadata_2 //gets owner token info
* metadataEXT(Text) -> ?Blob - supports metadata() for legacy support. - the collection properties should be converted to a blob standard that a client can decipher(cbor?/protobuf?); //will have to manage multi chunks //nyi
* tokens_ext(request: Text) : async Result.Result<[Types.EXTTokensResult]; //used by stoic to get tokens for a principal.


### Large NFT Assets
Expand Down Expand Up @@ -1997,27 +2015,31 @@ Features:
};

```


### HTTP NFT Information

prptl.io/_/canister_id/_/token_id - Returns the primary asset
prptl.io/-/canister-id/-/token_id - Returns the primary asset

prptl.io/_/canister_id/_/token_id/preview - Returns the preview asset
prptl.io/-/canister_id/-/token_id/preview - Returns the preview asset

prptl.io/_/canister_id/_/token_id/ex - Origyn NFTs are self contained internet addressable objects. All the data for rendering is contained inside the NFT (authors can choose to host data on other platforms). Returns an HTML interface that displays the NFT according to the NFT authors specification.
prptl.io/-/canister_id/-/token_id/ex - Origyn NFTs are self contained internet addressable objects. All the data for rendering is contained inside the NFT (authors can choose to host data on other platforms). Returns an HTML interface that displays the NFT according to the NFT authors specification.

prptl.io/_/canister_id/_/token_id/_/library_id - Returns the asset in the library
prptl.io/-/canister_id/-/token_id/-/library_id - Returns the asset in the library

prptl.io/_/canister_id/_/token_id/_/library_id/info - Returns a json representation of assets in the library
prptl.io/-/canister_id/-/token_id/-/library_id/info - Returns a json representation of assets in the library

prptl.io/_/canister_id/_/token_id/info - Returns a json representation of the metadata, including the library items
prptl.io/-/canister_id/-/token_id/info - Returns a json representation of the metadata, including the library items

prptl.io/_/canister_id/_/token_id/info?query=[Query] - Returns a json representation of the metadata passed through a query
prptl.io/-/canister_id/-/token_id/info?query=[Query] - Returns a json representation of the metadata passed through a query

prptl.io/-/canister_id/-/token_id/translate - Returns a json representation of translations to ext and dip721

### Collection Information

prptl.io/_/canister_id/collection - Returns a json representation of collection information
prptl.io/-/canister_id/collection - Returns a json representation of collection information

prptl.io/-/canister_id/collection/translate - Returns a json representation of token ids with translations to ext and dip721



* http routes - /ledger_info/{page}/{page_size} now returns the ledger json for the collection level
* http routes - /-/token_id/ledger_info/{page}/{page_size} now returns the ledger json for the token level
Expand Down
5 changes: 5 additions & 0 deletions package-set.dhall
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,11 @@ let additions =
, version = "v0.1.10"
, dependencies = ["base"]
},
{ name = "candy_0_1_12"
, repo = "https://github.com/aramakme/candy_library.git"
, version = "v0.1.12"
, dependencies = ["base"]
},
{
name="principalmo",
repo = "https://github.com/aviate-labs/principal.mo.git",
Expand Down
39 changes: 39 additions & 0 deletions src/origyn_nft_reference/http.mo
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1582,6 +1582,22 @@ module {

return json(#Array(#frozen(Metadata.ledger_to_candy(ledger, page, size))), null);
};

if(path_array[2] == "translate"){

debug if(debug_channel.request) D.print("render translate " # token_id );

let translation = #Class([
{name="origyn_nft"; value=#Text(token_id); immutable=true;},
{name="ext"; value=#Text(Types._getEXTTokenIdentifier(token_id, state.canister())); immutable=true;},
{name="dip721"; value=#Text(Nat.toText(NFTUtils.get_token_id_as_nat(token_id))); immutable=true;}
]);



return json(translation, null);
};



if(path_size > 3){
Expand Down Expand Up @@ -1763,7 +1779,30 @@ module {

return json(#Array(#frozen(Metadata.ledger_to_candy(ledger, page, size))), null);
};
if(path_array[1]== "translate"){
let rawkeys = if(NFTUtils.is_owner_manager_network(state, caller) == true){
Iter.toArray<Text>(Iter.filter<Text>(Map.keys(state.state.nft_metadata), func (x : Text){ x != ""}));

} else {
Iter.toArray<Text>(Iter.filter<Text>(Map.keys(state.state.nft_ledgers), func (x : Text){ x != ""}));
};

let translation = Array.map<Text, CandyTypes.CandyValue>(rawkeys, func(x){

return #Class([
{name="origyn_nft"; value=#Text(x); immutable=true;},
{name="ext"; value=#Text(Types._getEXTTokenIdentifier(x, state.canister())); immutable=true;},
{name="dip721"; value=#Text(Nat.toText(NFTUtils.get_token_id_as_nat(x))); immutable=true;}
]);
});


return json(#Array(#frozen(translation)), null);

};

} else {

debug if(debug_channel.request) D.print("collection info");
let keys = let keys = if(NFTUtils.is_owner_manager_network(state, caller) == true){
Array.map<Text, CandyTypes.CandyValue>(Iter.toArray<Text>(Iter.filter<Text>(Map.keys(state.state.nft_metadata), func (x : Text){ x != ""})), func (x:Text){#Text(x)}); // Should always have the "" item and need to remove it
Expand Down
Loading