1. Oracle Blockchain Platform 사용
  2. 로코드 블록체인 앱 빌더로 체인코드 구축
  3. 블록체인 앱 빌더를 사용한 토큰화 지원
  4. ERC-721(오류-721)
  5. ERC-721용 비계 TypeScript NFT 프로젝트

ERC-721용 비계 TypeScript NFT 프로젝트

Blockchain App Builder는 NFT 사양 파일에서 입력을 가져와 완전한 기능을 갖춘 비계 체인 코드 프로젝트를 생성합니다.

프로젝트는 CRUD 및 비CRUD 메서드를 포함한 NFT 라이프사이클 클래스 및 함수와 토큰화 SDK를 자동으로 생성합니다. 인수 검증, 마셜링/마셜링 해제 및 투명한 지속성 기능은 모두 자동으로 지원됩니다.

비계 프로젝트 및 NFT와 직접 관련되지 않은 메소드에 대한 자세한 내용은 Scaffolded TypeScript Chaincode Project를 참조하십시오.

참조:

모델

토큰화된 모든 모델 클래스는 OchainModel 클래스를 확장합니다. Transparent Persistence Capability 또는 단순화된 ORM은 OchainModel 클래스에서 캡처됩니다. 

import * as yup from 'yup';
import { Id, Mandatory, Validate, Default, Embedded, Derived, ReadOnly } from '../../lib/decorators';
import { OchainModel } from '../../lib/ochain-model';
import { STRATEGY } from '../../lib/utils';
import { EmbeddedModel } from '../../lib/ochain-embedded-model';

export class ArtCollectionMetadata extends EmbeddedModel<ArtCollectionMetadata> {
    @Validate(yup.string())
    public painting_name: string;

    @Validate(yup.string())
    public description: string;

    @Validate(yup.string())
    public image: string;

    @Validate(yup.string())
    public painter_name: string;

}
    
@Id('tokenId')       
export class ArtCollection extends OchainModel<ArtCollection> {

    public readonly assetType = 'otoken';
        
    @Mandatory()
    @Validate(yup.string().required().matches(/^[A-Za-z0-9][A-Za-z0-9_-]*$/).max(16))
    public tokenId: string;

    @ReadOnly('artcollection')
    public tokenName: string;

    @Validate(yup.string().trim().max(256))
    public tokenDesc: string;

    @ReadOnly('ART')
    public symbol: string;

    @ReadOnly('erc721+')
    public tokenStandard: string;

    @ReadOnly('nonfungible')
    public tokenType: string;

    @ReadOnly('whole')
    public tokenUnit: string;

      @ReadOnly(["indivisible","singleton","mintable","transferable","burnable","roles"])
    public behaviors: string[];

    @ReadOnly({minter_role_name: "minter"})
    public roles: object;

    @ReadOnly({max_mint_quantity: 20000})
    public mintable: object;

    @Validate(yup.string())
    public owner: string;

    @Validate(yup.string())
    public createdBy: string;

    @Validate(yup.string())
    public transferredBy: string;

    @Validate(yup.string())
    public creationDate: string;

    @Validate(yup.string())
    public transferredDate: string;

    @Validate(yup.bool())
    public isBurned: boolean;

    @Validate(yup.string())
    public burnedBy: string;

    @Validate(yup.string())
    public burnedDate: string;

    @Validate(yup.string().max(2000))
    public tokenUri: string;
    
    @Embedded(ArtCollectionMetadata)
    public metadata: ArtCollectionMetadata;

    @Validate(yup.number())
    public price: number;

    @Validate(yup.boolean())
    public on_sale_flag: boolean;

}

컨트롤러

기본 컨트롤러 클래스는 OchainController 클래스를 확장합니다. 하나의 주 컨트롤러만 있습니다. 

export class DigiCurrCCController extends OchainController{

클래스, 함수 또는 파일을 원하는 만큼 만들 수 있지만 주 컨트롤러 클래스 내에 정의된 메소드만 호출할 수 있습니다. 다른 방법은 숨겨져 있습니다.

토큰 SDK 메소드를 사용하여 비즈니스 애플리케이션에 대한 사용자정의 메소드를 작성할 수 있습니다.

자동으로 생성된 NFT 메소드

Blockchain App Builder는 NFT 및 NFT 라이프 사이클을 지원하는 방법을 자동으로 생성합니다. 이러한 방법을 사용하여 추가 코딩 없이 NFT를 초기화하고 역할 및 계정을 관리하며 기타 NFT 수명 주기 작업을 완료할 수 있습니다. 컨트롤러 메소드를 호출하려면 @Validator(...params) 데코레이터가 있어야 합니다.

액세스 제어 관리 방법

addTokenAdmin
이 메소드는 사용자를 체인 코드의 Token Admin로 추가합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@Validator(yup.string(), yup.string())
public async addTokenAdmin(orgId: string, userId: string) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ADMIN.addAdmin', 'TOKEN');
    return await this.Ctx.ERC721Admin.addAdmin(orgId, userId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 체인 코드의 Token Admin로 추가된 사용자의 세부정보를 포함하는 메시지입니다.
반환 값 예제:
{"msg":"Successfully added Admin (orgId: Org1MSP, userId: User1)"}
removeTokenAdmin
이 메소드는 사용자를 체인 코드의 Token Admin로 제거합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@Validator(yup.string(), yup.string())
public async removeTokenAdmin(orgId: string, userId: string) {
   await this.Ctx.ERC721Auth.checkAuthorization('ERC721ADMIN.removeAdmin', 'TOKEN');
   return await this.Ctx.ERC721Admin.removeAdmin(orgId, userId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 체인 코드의 Token Admin로 제거된 사용자의 세부정보를 포함하는 메시지입니다.
반환 값 예제:
{"msg": "Successfully removed Admin (orgId: Org1MSP, userId: User1)"}
isTokenAdmin
이 메소드는 함수 호출자가 Token Admin인 경우 부울 값 true를 반환하고, 그렇지 않은 경우 false를 반환합니다. Token Admin는 블록체인 네트워크의 다른 사용자에 대해 이 기능을 호출할 수 있습니다. 다른 사용자는 자신의 계정에서만 이 메소드를 호출할 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
public async isTokenAdmin(orgId: string, userId: string) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ADMIN.isUserTokenAdmin', 'TOKEN');
    return await this.Ctx.ERC721Auth.isUserTokenAdmin(orgId, userId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 호출자가 Token Admin인 경우 이 메소드는 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.
반환 값 예제:
{"result": true}
getAllTokenAdmins
이 메소드는 체인 코드의 Token Admin인 모든 사용자 목록을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@GetMethod()
@Validator()
public async getAllTokenAdmins() {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ADMIN.getAllAdmins', 'TOKEN');
    return await this.Ctx.ERC721Admin.getAllAdmins();
}
매개변수:
  • 없음
반환값:
  • 성공 시 orgId 및 userId 객체를 포함하는 JSON 형식의 admins 배열입니다.
반환 값 예제:
{"admins":[{"orgId":"Org1MSP","userId":"admin"}]}

토큰 구성 관리 방법

init
이 메소드는 체인 코드를 인스턴스화할 때 호출됩니다. 모든 Token Admin는 adminList 매개변수의 userId 및 orgId 정보로 식별됩니다. userId는 인스턴스 소유자 또는 인스턴스에 로그인한 사용자의 사용자 이름 또는 전자메일 ID입니다. orgId는 현재 네트워크 조직에 있는 사용자의 MSP(멤버쉽 서비스 제공자) ID입니다. adminList 매개변수는 체인코드를 처음 배포할 때 필수입니다. 체인코드를 업그레이드하는 경우 빈 목록([])을 전달합니다. adminList 매개변수의 다른 정보는 업그레이드 중 무시됩니다. 
@Validator(yup.array().of(yup.object()).nullable())
public async init(adminList: ERC721TokenAdminAsset[]) {
   await this.Ctx.ERC721Admin.initAdmin(adminList);
   await this.Ctx.ERC721Token.saveClassInfo(<NFT_NAME>);
   await this.Ctx.ERC721Token.saveDeleteTransactionInfo();
   return;
}
매개변수:
  • adminList array - 토큰 관리자 목록을 지정하는 {orgId, userId} 정보의 배열입니다. adminList 배열은 필수 매개변수입니다.
getAllTokens
이 메소드는 상태 데이터베이스에 저장된 모든 토큰 자산을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 이 방법은 Berkeley DB SQL 서식 있는 쿼리를 사용하며 원격 Oracle Blockchain Platform 네트워크에 연결된 경우에만 호출할 수 있습니다. 
@GetMethod()
@Validator()
public async getAllTokens() {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.getAllTokens', 'TOKEN');
    return await this.Ctx.ERC721Token.getAllTokens();
}
매개변수:
  • 없음
반환값:
  • JSON 형식의 모든 토큰 자산 목록입니다.
반환 값 예제:
[
    {
        "key": "monalisa",
        "valueJson": {
            "metadata": {
                "PaintingName": "Mona_Lisa",
                "Description": "Mona Lisa Painting",
                "Image": "monalisa.jpeg",
                "PainterName": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "ravinft",
            "tokenDesc": "token Description",
            "symbol": "PNT",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter",
                "burner_role_name": "burner"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "createdBy": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "creationDate": "2022-04-07T21:17:48.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "NftBasePrice": 100
        }
    },
    {
        "key": "monalisa1",
        "valueJson": {
            "metadata": {
                "PaintingName": "Mona_Lisa",
                "Description": "Mona Lisa Painting",
                "Image": "monalisa.jpeg",
                "PainterName": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa1",
            "tokenName": "ravinft",
            "tokenDesc": "token Description",
            "symbol": "PNT",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter",
                "burner_role_name": "burner"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "createdBy": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "creationDate": "2022-04-07T21:17:59.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "NftBasePrice": 100
        }
    }
]
getAllTokensByUser
이 메소드는 지정된 사용자가 소유한 모든 토큰 자산을 반환합니다. 이 방법은 Berkeley DB SQL 서식 있는 쿼리를 사용하며 원격 Oracle Blockchain Platform 네트워크에 연결된 경우에만 호출할 수 있습니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
public async getAllTokensByUser(orgId: string, userId: string) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.getAllTokensByUser', 'TOKEN', { accountId });
    return await this.Ctx.ERC721Token.getAllTokensByUser(accountId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • JSON 형식의 토큰 자산 목록입니다.
반환 값 예제:
[
    {
        "key": "monalisa",
        "valueJson": {
            "metadata": {
                "PaintingName": "Mona_Lisa",
                "Description": "Mona Lisa Painting",
                "Image": "monalisa.jpeg",
                "PainterName": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "ravinft",
            "tokenDesc": "token Description",
            "symbol": "PNT",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter",
                "burner_role_name": "burner"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "createdBy": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "creationDate": "2022-04-07T21:17:48.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "NftBasePrice": 100
        }
    },
    {
        "key": "monalisa1",
        "valueJson": {
            "metadata": {
                "PaintingName": "Mona_Lisa",
                "Description": "Mona Lisa Painting",
                "Image": "monalisa.jpeg",
                "PainterName": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa1",
            "tokenName": "ravinft",
            "tokenDesc": "token Description",
            "symbol": "PNT",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter",
                "burner_role_name": "burner"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "createdBy": "oaccount~543c2258e351c3e7a40ea59b81e62154d38fbfc9d1b5b79f30ac5e08e7d0dfd1",
            "creationDate": "2022-04-07T21:17:59.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "NftBasePrice": 100
        }
    }
]
getTokenById
이 메소드는 토큰이 상태 데이터베이스에 있는 경우 토큰 객체를 반환합니다. 이 메소드는 체인 코드 또는 토큰 소유자의 Token Admin에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string())
public async getTokenById(tokenId: string) {
   await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.get', 'TOKEN', { tokenId });
   let token = await this.getTokenObject(tokenId);
   return token;
}
매개변수:
  • tokenId: string - 가져올 토큰의 ID입니다.
반환값:
  • JSON 형식의 토큰 자산입니다.
반환 값 예제:
{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "transferredBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "transferredDate": "2022-04-05T09:28:30.000Z",
    "isBurned": false,
    "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
    "price": 100,
    "on_sale_flag": true
}
getTokenHistory
이 메소드는 지정된 토큰 ID에 대한 내역을 반환합니다. 비동기 방식입니다. 이 메소드는 원격 Oracle Blockchain Platform 네트워크에 접속된 경우에만 호출할 수 있습니다. 누구나 이 메소드를 호출할 수 있습니다.
@GetMethod()
@Validator(yup.string())
public async getTokenHistory(tokenId: string) {
   // await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.history', 'TOKEN');
   return await this.Ctx.ERC721Token.history(tokenId);
}
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환 값 예제:
[
    {
        "trxId": "ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timeStamp": 1649150910,
        "value": {
            "metadata": {
                "painting_name": "Mona_Lisa",
                "description": "Mona Lisa Painting",
                "image": "monalisa.jpeg",
                "painter_name": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "artcollection",
            "tokenDesc": "token description",
            "symbol": "ART",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "transferredBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate": "2022-04-05T08:30:42.000Z",
            "transferredDate": "2022-04-05T09:28:30.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "price": 100,
            "on_sale_flag": true
        }
    },
    {
        "trxId": "cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timeStamp": 1649149545,
        "value": {
            "metadata": {
                "painting_name": "Mona_Lisa",
                "description": "Mona Lisa Painting",
                "image": "monalisa.jpeg",
                "painter_name": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "artcollection",
            "tokenDesc": "token description",
            "symbol": "ART",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
            "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "transferredBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate": "2022-04-05T08:30:42.000Z",
            "transferredDate": "2022-04-05T09:05:45.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "price": 100,
            "on_sale_flag": true
        }
    },
    {
        "trxId": "702e61cc8d6d2982521023d0d5f3195900f35e146d6a90ef66daae551e6075d2",
        "timeStamp": 1649147729,
        "value": {
            "metadata": {
                "painting_name": "Mona_Lisa",
                "description": "Mona Lisa Painting",
                "image": "monalisa.jpeg",
                "painter_name": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "artcollection",
            "tokenDesc": "token description",
            "symbol": "ART",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate": "2022-04-05T08:30:42.000Z",
            "isBurned": false,
            "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
            "price": 100,
            "on_sale_flag": true
        }
    },
    {
        "trxId": "e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timeStamp": 1649147442,
        "value": {
            "metadata": {
                "painting_name": "Mona_Lisa",
                "description": "Mona Lisa Painting",
                "image": "monalisa.jpeg",
                "painter_name": "Leonardo_da_Vinci"
            },
            "assetType": "otoken",
            "tokenId": "monalisa",
            "tokenName": "artcollection",
            "tokenDesc": "token description",
            "symbol": "ART",
            "tokenStandard": "erc721+",
            "tokenType": "nonfungible",
            "tokenUnit": "whole",
            "behaviors": [
                "indivisible",
                "singleton",
                "mintable",
                "transferable",
                "burnable",
                "roles"
            ],
            "roles": {
                "minter_role_name": "minter"
            },
            "mintable": {
                "max_mint_quantity": 20000
            },
            "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate": "2022-04-05T08:30:42.000Z",
            "isBurned": false,
            "tokenUri": "\"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg\"",
            "price": 100,
            "on_sale_flag": false
        }
    }
]
getTokenObject
지정된 토큰 ID에 대한 토큰 인스턴스를 반환하는 유틸리티 메소드입니다. 이 메소드는 토큰 객체를 인출하기 위해 자동으로 생성된 많은 메소드에서 사용됩니다. 사용자정의 메소드에서 필요에 따라 이 메소드를 호출할 수 있습니다. 토큰화된 자산 또는 클래스를 생성할 때 올바른 토큰 객체를 반환하도록 스위치 케이스를 해당하는 Token 클래스로 업데이트하십시오. Blockchain App Builder의 ochain sync 명령은 토큰화된 자산이 사양 파일에 생성될 때 스위치 케이스를 자동으로 생성합니다. 이 메서드에는 @Validator() 메서드 데코레이터가 없습니다. 즉, 이 메서드는 직접 호출할 수 없으며 다른 메서드에서만 호출할 수 있습니다. 
public async getTokenObject<T extends OchainModel<any>>(tokenId: string): Promise<T> {
   if (!tokenId) {
        throw Error('TokenID cannot be null/empty.');
    }
    const token = await this.Ctx.ERC721Token.get(tokenId);
    if (token.tokenName && token.assetType && token.assetType === 'otoken') {
        let tokenAsset;
        switch (token.tokenName) {
           case '<NFT_NAME in lowercase>':
               tokenAsset = new <NFT_NAME>(token, false, true);
               return tokenAsset;
           default:
               throw new Error(`No token exists with ID [${tokenId}]`);
        }
    } else {
        throw new Error(`No token exists with ID [${tokenId}]`);
    }
}
매개변수:
  • tokenId: string - 토큰의 ID입니다.
ownerOf
이 메소드는 지정된 토큰 ID의 소유자의 계정 ID를 반환합니다. 누구나 이 메소드를 호출할 수 있습니다.
@GetMethod()
@Validator(yup.string())
public async ownerOf(tokenId: string) {
   return await this.Ctx.ERC721Token.ownerOf(tokenId);
}
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 소유자 계정 ID의 JSON 객체입니다.
반환 값 예제:
{"owner": "oaccount~d6d22c3167e3c6ab9ee5653e1a008c37c20cc47ebb0229ca0aedfafe64c675b8"}
name
이 메소드는 토큰 클래스의 이름을 반환합니다. 누구나 이 메소드를 호출할 수 있습니다.
@GetMethod()
@Validator()
public async name() {
   return await this.Ctx.ERC721Token.name();
}
매개변수:
  • 없음
반환값:
  • 토큰 이름의 JSON 객체입니다.
반환 값 예제:
{"tokenName": "artcollection"}
symbol
이 메소드는 토큰 클래스의 기호를 반환합니다. 누구나 이 메소드를 호출할 수 있습니다.
@GetMethod()
@Validator()
public async symbol() {
   return await this.Ctx.ERC721Token.symbol();
}
매개변수:
  • 없음
반환값:
  • 토큰 기호의 JSON 객체입니다.
반환 값 예제:
{"symbol": "PNT"}
tokenURI
이 메소드는 지정된 토큰의 URI를 반환합니다. 누구나 이 메소드를 호출할 수 있습니다.
@GetMethod()
@Validator(yup.string())
public async tokenURI(tokenId: string) {
   return await this.Ctx.ERC721Token.tokenURI(tokenId);
}
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 토큰 URI의 JSON 객체입니다.
반환 값 예제:
{"tokenURI": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\
.ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg"}
totalSupply
이 메소드는 총 연동된 토큰 수를 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@GetMethod()
@Validator()
public async totalSupply() {
  await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.totalSupply', 'TOKEN');
  return await this.Ctx.ERC721Token.totalSupply();
}
매개변수:
  • 없음
반환값:
  • 성공 시 토큰 수의 JSON 객체입니다.
반환 값 예제:
{"totalSupply": 3}
totalNetSupply
이 메소드는 총 연동 토큰 수에서 연소된 토큰 수를 뺀 값을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@GetMethod()
@Validator()
public async totalNetSupply() {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.totalNetSupply', 'TOKEN');
    return await this.Ctx.ERC721Token.getTotalMintedTokens();
}
매개변수:
  • 없음
반환값:
  • 성공 시 토큰 수의 JSON 객체입니다.
반환 값 예제:
{"totalNetSupply": 1}

계정 관리 방법

createAccount
이 메소드는 지정된 사용자 및 토큰에 대한 계정을 생성합니다. 언제든지 토큰을 보유할 모든 사용자에 대해 계정을 만들어야 합니다. 계정은 사용자가 보유한 NFT 수를 추적합니다. 토큰 관련 작업을 완료하려면 네트워크에 계정이 있어야 합니다. 사용자당 하나의 NFT 계정만 생성할 수 있습니다.

계정 ID는 영숫자 문자 집합으로, 앞에 oaccount~이 붙고 그 뒤에 현재 네트워크 조직에 있는 사용자의 멤버쉽 서비스 제공자 ID(orgId)에 대한 SHA-256 해시, 인스턴스 소유자 또는 인스턴스에 로그인한 사용자의 사용자 이름 또는 전자 메일 ID(userId) 및 상수 문자열 nft가 붙습니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 

@Validator(yup.string(), yup.string(), yup.string())
public async createAccount(org_id: string, user_id: string, token_type: string) {
  await this.Ctx.Auth.checkAuthorization("ACCOUNT.createAccount", "TOKEN", { org_id });
  return await this.Ctx.Account.createAccount(org_id, user_id, token_type);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • tokenType: string - 지원되는 토큰 유형은 nonfungible뿐입니다.
반환값:
  • 성공 시 생성된 계정의 JSON 객체입니다. bapAccountVersion 매개변수는 계정 객체에서 내부용으로 정의됩니다.
반환 값 예제:
{
    "assetType": "oaccount",
    "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "bapAccountVersion": 0,
    "userId": "admin",
    "orgId": "Org1MSP",
    "tokenType": "nonfungible",
    "noOfNfts": 0
}
balanceOf
이 메소드는 지정된 사용자가 보유한 총 NFT 수를 반환합니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
 public async balanceOf(orgId: string, userId: string) {
     await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.balanceOf', 'TOKEN', { orgId, userId });
     const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
     return await this.Ctx.ERC721Account.balanceOf(accountId);
 }
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 현재 NFT 수의 JSON 객체입니다.
반환 값 예제:
{"totalNfts": 0}
getAllAccounts
이 메소드는 모든 계정 목록을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 이 방법은 Berkeley DB SQL 서식 있는 쿼리를 사용하며 원격 Oracle Blockchain Platform 네트워크에 연결된 경우에만 호출할 수 있습니다. 
@GetMethod()
@Validator()
public async getAllAccounts() {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.getAllAccounts', 'TOKEN');
    return await this.Ctx.ERC721Account.getAllAccounts();
}
매개변수:
  • 없음
반환값:
  • 성공 시 모든 계정의 JSON 배열입니다.
반환 값 예제:
[
    {
        "key": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "valueJson": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }    
    }
]
getAccountByUser
이 메소드는 지정된 사용자에 대한 계정 세부 정보를 반환합니다. 이 메소드는 체인 코드의 Token Admin 또는 계정의 Account Owner로만 호출할 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
public async getAccountByUser(orgId: string, userId: string) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.getAccountByUser', 'TOKEN', { orgId, userId });
    return await this.Ctx.ERC721Account.getAccountWithStatusByUser(orgId, userId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 다음 속성을 포함하는 JSON 계정 객체:
  • bapAccountVersion - 내부용 계정 객체 매개변수입니다.
  • status - 사용자 계정의 현재 상태입니다.
  • accountId - 사용자 계정의 ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • orgId - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • tokenType - 계정이 보유하는 토큰의 유형입니다.
  • noOfNfts - 계정이 보유한 총 NFT 수입니다.
반환 값 예제:
{
  "bapAccountVersion": 0,
  "assetType": "oaccount",
  "status": "active",
  "accountId": "oaccount~cc301bee057f14236a97d434909ec1084970921b008f6baab09c2a0f5f419a9a",
  "userId": "idcqa",
  "orgId": "appdev",
  "tokenType": "nonfungible",
  "noOfNfts": 0
}
getUserByAccountId
이 메소드는 지정된 계정의 사용자 세부 정보를 반환합니다. 이 방법은 모든 사용자가 호출할 수 있습니다.
@GetMethod()
@Validator(yup.string())
public async getUserByAccountId(accountId: string) {
    return await this.Ctx.ERC721Account.getUserByAccountId(accountId);
}
매개변수:
  • accountId: string - 계정의 ID입니다.
반환값:
  • 성공 시 사용자 세부정보의 JSON 객체(orgId 및 userId)입니다.
반환 값 예제:
{
  "userId": "admin",
  "orgId": "Org1MSP"
}
getAccountHistory
이 메소드는 지정된 사용자에 대한 계정 기록을 반환합니다. 비동기 방식입니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
public async getAccountHistory(orgId: string, userId: string) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.history', 'TOKEN', { accountId });
    return await this.Ctx.ERC721Account.history(accountId);
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 계정 기록의 JSON 객체입니다. bapAccountVersion 매개변수는 계정 객체에서 내부용으로 정의됩니다.
반환 값 예제:
[
    {
        "trxId": "6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
        "timeStamp": 1649151044,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 5,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "a605f1fa62e511c2945fce5437f983a5e70ec814b82520d3ecd2d81e3ecf53a3",
        "timeStamp": 1649151022,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 4,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 2
        }
    },
    {
        "trxId": "ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timeStamp": 1649150910,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 3,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timeStamp": 1649149545,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 2,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 0
        }
    },
    {
        "trxId": "e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timeStamp": 1649147442,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 1,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "d2d1f9c898707ae831e9361bc25da6369eac37b10c87dc04d18d6f3808222f08",
        "timeStamp": 1649137534,
        "value": {
            "assetType": "oaccount",
            "bapAccountVersion" : 0,
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 0
        }
    }
]

역할 관리 방법

addRole
이 메소드는 지정된 사용자에게 역할을 추가합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@Validator(yup.string(), yup.string(), yup.string())
public async addRole(role: string, orgId: string, userId: string) {
   const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
   await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.addRoleMember', 'TOKEN');
   return await this.Ctx.ERC721Token.addRoleMember(role, accountId);
}
매개변수:
  • role: string - 지정된 사용자에 추가할 롤의 이름입니다. mintable 및 burnable 동작은 사양 파일의 minter_role_name 및 burner_role_name 속성에 해당합니다.
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 메시지입니다.
반환 값 예제:
{"msg": "Successfully added role 'minter' to Account Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}
removeRole
이 메소드는 지정된 유저로부터 롤을 제거합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@Validator(yup.string(), yup.string(), yup.string())
public async removeRole(role: string, orgId: string, userId: string) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.removeRoleMember', 'TOKEN');
    return await this.Ctx.ERC721Token.removeRoleMember(role, accountId);
}
매개변수:
  • role: string - 지정된 사용자로부터 제거할 롤의 이름입니다. mintable 및 burnable 동작은 사양 파일의 minter_role_name 및 burner_role_name 속성에 해당합니다.
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 메시지입니다.
반환 값 예제:
{"msg": "Successfully removed role 'minter' from Account Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1)"}
getAccountsByRole
이 메소드는 지정된 롤에 대한 모든 계정 ID 목록을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@GetMethod()
@Validator(yup.string())
public async getAccountsByRole(role: string) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ROLE.getAccountsByRole', 'TOKEN');
    return await this.Ctx.ERC721Role.getAccountsByRole(role);
}
매개변수:
  • role: string - 검색할 역할의 이름입니다.
반환값:
  • 성공 시 JSON 계정 ID 배열입니다.
반환 값 예제:
{
    "accounts": [
        "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d"
    ]
}
getUsersByRole
이 메소드는 지정된 롤에 대한 모든 사용자 목록을 반환합니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@GetMethod()
@Validator(yup.string())
public async getUsersByRole(role: string) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ROLE.getUsersByRole', 'TOKEN');
    return await this.Ctx.ERC721Role.getUsersByRole(role);
}
매개변수:
  • role: string - 검색할 역할의 이름입니다.
반환값:
  • 성공 시 사용자 객체의 JSON 배열(orgId 및 userId)입니다.
반환 값 예제:
{
    "users": [
        {
            "userId": "admin",
            "orgId": "Org1MSP"
        }
    ]
}
isInRole
이 메소드는 사용자에게 지정된 롤이 있는지 여부를 나타내는 부울 값을 반환합니다. 이 메소드는 체인 코드의 Token Admin 또는 계정의 Account Owner로만 호출할 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string(), yup.string())
public async isInRole(orgId: string, userId: string, role: string) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TOKEN.isInRole', 'TOKEN',{ accountId });
    return { result: await this.Ctx.ERC721Token.isInRole(role, accountId) };
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • role: string - 검색할 역할의 이름입니다.
반환값:
  • 성공 시 부울 결과의 JSON 문자열입니다.
반환 값 예제:
{"result":"true"}

트랜잭션 내역 관리 방법

getAccountTransactionHistory
이 메소드는 지정된 사용자에 대한 계정 트랜잭션 기록을 반환합니다. 비동기 방식입니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string())
public async getAccountTransactionHistory(orgId: string, userId: string) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.getAccountTransactionHistory', 'TOKEN', { accountId });
    return await this.Ctx.ERC721Account.getAccountTransactionHistory(accountId)
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환 값 예제:
[
    {
        "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
        "timestamp": "2022-04-05T09:30:44.000Z",
        "tokenId": "monalisa1",
        "noOfNfts": 1,
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "BURN"
    },
    {
        "transactionId": "otransaction~a605f1fa62e511c2945fce5437f983a5e70ec814b82520d3ecd2d81e3ecf53a3",
        "timestamp": "2022-04-05T09:30:22.000Z",
        "tokenId": "monalisa1",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    },
    {
        "transactionId": "otransaction~ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timestamp": "2022-04-05T09:28:30.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "CREDIT"
    },
    {
        "transactionId": "otransaction~cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timestamp": "2022-04-05T09:05:45.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "DEBIT"
    },
    {
        "transactionId": "otransaction~e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timestamp": "2022-04-05T08:30:42.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    }
]
getAccountTransactionHistoryWithFilters
이 메소드는 PageSize, Bookmark, startTime 및 endTime로 필터링된 지정된 사용자에 대한 계정 트랜잭션 내역을 반환합니다. 비동기 방식입니다. 이 메소드는 원격 Oracle Blockchain Platform 네트워크에 접속된 경우에만 호출할 수 있습니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string(), yup.string(), yup.object().nullable())
public async getAccountTransactionHistoryWithFilters(orgId: string, userId: string, filters ?: Filters) {
    const accountId = await this.Ctx.ERC721Account.generateAccountId(orgId, userId);
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721ACCOUNT.getAccountTransactionHistoryWithFilters', 'TOKEN', { accountId });
    return await this.Ctx.ERC721Account.getAccountTransactionHistoryWithFilters(accountId, filters)
}
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • filters: object - pageSize, bookmark, startTime 및 endTime의 네 가지 속성을 포함하는 Filter 클래스의 객체입니다.
반환 값 예제:
[
    {
        "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
        "timestamp": "2022-04-05T09:30:44.000Z",
        "tokenId": "monalisa1",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "BURN"
    },
    {
        "transactionId": "otransaction~a605f1fa62e511c2945fce5437f983a5e70ec814b82520d3ecd2d81e3ecf53a3",
        "timestamp": "2022-04-05T09:30:22.000Z",
        "tokenId": "monalisa1",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    },
    {
        "transactionId": "otransaction~ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timestamp": "2022-04-05T09:28:30.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "CREDIT"
    },
    {
        "transactionId": "otransaction~cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timestamp": "2022-04-05T09:05:45.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "DEBIT"
    },
    {
        "transactionId": "otransaction~e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timestamp": "2022-04-05T08:30:42.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    }
]
getTransactionById
이 메소드는 지정된 트랜잭션 ID에 대한 트랜잭션 기록을 반환합니다. 비동기 방식입니다. 이 메소드는 체인 코드의 Token Admin 또는 계정 소유자에 의해서만 호출될 수 있습니다. 
@GetMethod()
@Validator(yup.string())
public async getTransactionById(transactionId: string) {
    return await this.Ctx.ERC721Transaction.getTransactionById(transactionId);
}
매개변수:
  • transactionId: string - 16진수 형식의 64비트 해시 뒤에 오는 otransaction~ 접두어인 트랜잭션의 ID입니다.
반환 값 예제:
{
    "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
    "history": [
        {
            "trxId": "6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
            "timeStamp": 1649151044,
            "value": {
                "assetType": "otransaction",
                "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
                "tokenId": "monalisa1",
                "fromAccountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
                "toAccountId": "",
                "triggeredByAccountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
                "transactionType": "BURN",
                "timestamp": "2022-04-05T09:30:44.000Z",
            }
        }
    ]
}
deleteHistoricalTransactions
이 메소드는 상태 데이터베이스에서 지정된 시간 기록보다 오래된 트랜잭션을 삭제합니다. 비동기 방식입니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 
@Validator(yup.date())
public async deleteHistoricalTransactions(timeToExpiration: Date) {
    await this.Ctx.ERC721Auth.checkAuthorization('ERC721TRANSACTION.deleteTransactions', 'TOKEN');
    return await this.Ctx.ERC721Transaction.deleteTransactions(timeToExpiration);
}
매개변수:
  • timestamp: string - 시간 기록입니다. 시간 기록 이전의 모든 트랜잭션이 삭제됩니다.
반환 값 예제:
{
    "msg": "Successfuly deleted transaction older than date: Thu Apr 07 2022 21:18:59 GMT+0000 (Coordinated Universal Time).",
    "transactions": [
        "otransaction~30513757d8b647fffaafac440d743635f5c1b2e41b25ebd6b70b5bbf78a2643f",
        "otransaction~ac0e908c735297941ba58bb208ee61ff4816a1e54c090d68024f82adf743892b"
    ]
}

토큰 동작 관리 방법 - 민트 가능한 동작

create<Token Name>Token
이 메소드는 NFT를 생성(분)합니다. 자산 및 연관된 속성이 상태 데이터베이스에 저장됩니다. 이 트랜잭션의 호출자에게 토큰 계정이 있어야 합니다. 이 트랜잭션의 호출자가 NFT의 소유자가 됩니다. 토큰 사양 파일에 behaviors에 대한 roles 섹션과 roles에 대한 minter_role_name 속성이 포함된 경우 트랜잭션 호출자에게 minter 롤이 있어야 합니다. 그렇지 않으면 모든 호출자가 NFT를 민트할 수 있습니다. 
@Validator(< Token Class >)
public async create< Token Name >Token(tokenAsset: <Token Class>) {
    return await this.Ctx.ERC721Token.createToken(tokenAsset);
}
매개변수:
  • tokenAsset: <Token Class> - 민트할 토큰 자산입니다. 토큰 자산의 속성에 대한 자세한 내용은 입력 사양 파일을 참조하십시오.
반환값:
  • 성공 시 다음 속성을 포함하는 JSON 토큰 자산 객체:
  • metadata - 토큰을 설명하는 JSON 정보입니다.
  • createdBy - 토큰을 민트하기 위해 트랜잭션을 호출한 사용자의 계정 ID입니다.
  • creationDate - 트랜잭션의 시간 기록입니다.
  • isBurned - tokenId로 식별된 NFT가 레코딩되는지 여부를 나타내는 부울 값입니다.
  • tokenName - 토큰의 이름입니다.
  • tokenDesc - 토큰에 대한 설명입니다.
  • symbol - 토큰의 기호입니다.
  • tokenStandard - 토큰의 표준입니다.
  • tokenType - 이 계정이 보유한 토큰의 유형입니다.
  • tokenUnit - 토큰의 단위입니다.
  • behaviors - 모든 토큰 동작에 대한 설명입니다.
  • mintable - 민트 가능한 동작의 속성에 대한 설명입니다. max_mint_quantity 속성은 생성할 수 있는 이 토큰 클래스의 최대 NFT 수를 지정합니다.
  • owner - 토큰의 현재 소유자의 계정 ID입니다. 연동 프로세스 중 이 메소드의 호출자가 토큰의 소유자가 됩니다.
  • tokenUri - 토큰의 URI입니다.
반환 값 예제:
{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "isBurned": false,
    "tokenUri": "\"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg\"",
    "price": 100,
    "on_sale_flag": false
}
update<Token Name>Token
이 메소드는 토큰 속성을 업데이트합니다. 이 메소드는 토큰의 소유자 또는 생성자인 사용자만 호출할 수 있습니다. 토큰 자산이 생성된 후에는 토큰 소유자만 토큰 사용자정의 속성을 업데이트할 수 있습니다. 사용자가 토큰 소유자이자 토큰 생성자인 경우 TokenDesc 속성도 업데이트할 수 있습니다. 토큰 메타데이터를 업데이트할 수 없습니다. 특정 등록 정보만 업데이트하려는 경우에도 이 메소드에 모든 토큰 등록 정보를 전달해야 합니다. 
@Validator(<Token Class>)
public async update<Token name>Token(tokenAsset: <Token Class>) {
    return await this.Ctx.ERC721Token.updateToken(tokenAsset);
}
매개변수:
  • tokenAsset: <Token Class> - 업데이트할 토큰 자산입니다. 토큰 자산의 속성에 대한 자세한 내용은 입력 사양 파일을 참조하십시오.
반환값:
  • 성공 시 업데이트된 JSON 토큰 자산 객체입니다.
반환 값 예제:
{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "isBurned": false,
    "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
    "price": 100,
    "on_sale_flag": true
}

토큰 동작 관리 방법 - 전송 가능한 동작

safeTransferFrom
이것은 비동기 함수입니다. 이 메소드는 호출자에서 다른 계정으로 지정된 NFT의 소유권을 이전합니다. 이 메소드는 다음 검증을 포함합니다.
  • 토큰이 존재하며 레코딩되지 않습니다.
  • 발신자 계정과 수령인 계정이 있으며 동일한 계정이 아닙니다.
  • 발신자 계정은 토큰을 소유합니다.
  • 함수의 호출자가 발신자입니다.
@Validator(yup.string(), yup.string(), yup.string(), yup.string(), yup.string(), yup.string().max(2000))
public async safeTransferFrom(fromOrgId: string, fromUserId: string, toOrgId: string, toUserId: string, tokenId: string, data?: string) {
    const tokenAsset = await this.getTokenObject(tokenId);
    const fromAccountId = await this.Ctx.ERC721Account.generateAccountId(fromOrgId, fromUserId);
    const toAccountId = await this.Ctx.ERC721Account.generateAccountId(toOrgId, toUserId);
    return await this.Ctx.ERC721Token.safeTransferFrom(fromAccountId, toAccountId, tokenAsset, data);
}
매개변수:
  • fromOrgId: string - 현재 조직에 있는 발신자 및 토큰 소유자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • fromUserId: string - 발신자 및 토큰 소유자의 사용자 이름 또는 전자메일 ID입니다.
  • toOrgId: string - 현재 조직에 있는 수신자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • toUserId: string - 수신자의 사용자 이름 또는 전자메일 ID입니다.
  • tokenId: string - 전송할 토큰의 ID입니다.
  • data: string - 트랜잭션 레코드에 저장할 선택적 추가 정보입니다.
반환값:
  • 성공 시 발신자 및 수신자 계정 세부정보가 포함된 메시지입니다.
반환 값 예제:
{"msg": "Successfully transferred NFT token: 'monalisa' from Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin) to Account-Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1)"}
transferFrom
이것은 비동기 함수입니다. 이 방법은 지정된 NFT의 소유권을 발신자 계정에서 수신자 계정으로 이전합니다. 호출자는 정확한 파라미터를 전달해야 합니다. 이 메소드는 토큰 소유자뿐만 아니라 모든 사용자가 호출할 수 있습니다. 이 메소드는 다음 검증을 포함합니다.
  • 토큰이 존재하며 레코딩되지 않습니다.
  • 발신자 계정과 수령인 계정이 있으며 동일한 계정이 아닙니다.
  • 발신자 계정은 토큰을 소유합니다.
@Validator(yup.string(), yup.string(), yup.string(), yup.string(), yup.string())
public async transferFrom(fromOrgId: string, fromUserId: string, toOrgId: string, toUserId: string, tokenId: string) {
    const tokenAsset = await this.getTokenObject(tokenId);
    const fromAccountId = await this.Ctx.ERC721Account.generateAccountId(fromOrgId, fromUserId);
    const toAccountId = await this.Ctx.ERC721Account.generateAccountId(toOrgId, toUserId);
    return await this.Ctx.ERC721Token.transferFrom(fromAccountId, toAccountId, tokenAsset);
}
매개변수:
  • fromOrgId: string - 현재 조직에 있는 발신자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • fromUserId: string - 발신자의 사용자 이름 또는 전자메일 ID입니다.
  • toOrgId: string - 현재 조직에 있는 수신자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • toUserId: string - 수신자의 사용자 이름 또는 전자메일 ID입니다.
  • tokenId: string - 전송할 토큰의 ID입니다.
반환값:
  • 성공 시 발신자 및 수신자 계정 세부정보가 포함된 메시지입니다.
반환 값 예제:
{"msg": "Successfully transferred NFT token: 'monalisa' from Account-Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1) to Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}

토큰 동작 관리 방법 - 굽기 가능한 동작

burn
이 메소드는 호출자 계정에서 지정된 NFT를 비활성화하거나 레코딩합니다. 이 메서드의 호출자에 계정이 있어야 합니다.The caller of this method must have an account. 토큰 사양 파일에 burnable 동작이 포함되어 있지 않으면 토큰을 구울 수 없습니다. 사양 파일의 roles 섹션에 burner_role_name 속성이 지정되지 않은 경우 토큰 소유자가 토큰을 구울 수 있습니다. burner_role_name 속성이 roles 섹션에 지정된 경우 토큰의 채굴자(생성자) 또는 소유자인 버너 역할을 지정한 사용자가 토큰을 레코딩할 수 있습니다. 
@Validator(yup.string())
public async burn(tokenId: string) {
    const tokenAsset = await this.getTokenObject(tokenId);
    return await this.Ctx.ERC721Token.burn(tokenAsset);
}
매개변수:
  • tokenId: string - 구울 토큰의 ID입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 메시지입니다.
반환 값 예제:
{"msg": "Successfully burned NFT token: 'monalisa1' from Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}
burnNFT
이 메소드는 호출자 계정에서 지정된 NFT를 비활성화하거나 레코딩하고 토큰 객체 및 토큰 내역을 반환합니다. 이 메서드의 호출자에 계정이 있어야 합니다.The caller of this method must have an account. 토큰 사양 파일에 burnable 동작이 포함되어 있지 않으면 토큰을 구울 수 없습니다. 사양 파일의 roles 섹션에 burner_role_name 속성이 지정되지 않은 경우 토큰 소유자가 토큰을 구울 수 있습니다. burner_role_name 속성이 roles 섹션에 지정된 경우 토큰의 채굴자(생성자) 또는 소유자인 버너 역할을 지정한 사용자가 토큰을 레코딩할 수 있습니다. 
@Validator(yup.string())
public async burnNFT(tokenId: string) {
    const token = await this.Ctx.ERC721Token.get(tokenId)
    if (token.isBurned === true) {
      throw new Error(`token with tokenId ${tokenId} is already burned`);
    }
    const tokenHistory = await this.Ctx.ERC721Token.history(tokenId);
    await this.burn(tokenId);
    token.tokenId = parseInt(token.tokenId);
    if(Number.isNaN(token.tokenId)) {
      throw new Error(`tokenId is expected to be integer but found ${tokenId}`)
    }
    token.isBurned = true;
    return {...token, tokenHistory: JSON.stringify(tokenHistory)};
}
매개변수:
  • tokenId: string - 구울 토큰의 ID입니다.
반환값:
  • 성공 시 토큰 내역 정보를 포함하는 토큰 객체입니다.
반환 값 예제:
{
    "assetType": "otoken",
    "tokenId": 1,
    "tokenName": "artcollection",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2023-08-22T07:36:50.000Z",
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "isBurned": true,
    "tokenUri": "example.com",
    "price": 120,
    "on_sale_flag": false,
    "tokenHistory": "[{\"trxId\":\"732438a85b5e8fc76c5254e54602b29d583543b103fafb5a28c0df384428bb50\",\"timeStamp\":\"2023-08-22T07:36:50.000Z\",\"value\":{\"assetType\":\"otoken\",\"tokenId\":\"1\",\"tokenName\":\"artcollection\",\"symbol\":\"ART\",\"tokenStandard\":\"erc721+\",\"tokenType\":\"nonfungible\",\"tokenUnit\":\"whole\",\"behaviors\":[\"indivisible\",\"singleton\",\"mintable\",\"transferable\",\"burnable\",\"roles\"],\"roles\":{\"minter_role_name\":\"minter\"},\"mintable\":{\"max_mint_quantity\":20000},\"createdBy\":\"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d\",\"creationDate\":\"2023-08-22T07:36:50.000Z\",\"owner\":\"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d\",\"isBurned\":false,\"tokenUri\":\"example.com\",\"price\":120,\"on_sale_flag\":false}}]"
}

사용자정의 방법

토큰 SDK 메소드를 사용하여 비즈니스 애플리케이션에 대한 사용자정의 메소드를 작성할 수 있습니다.

다음 예에서는 사용자정의 메소드에서 토큰 SDK 메소드를 사용하는 방법을 보여줍니다. sell 메소드가 호출되면 지정된 가격에 판매할 토큰이 게시됩니다. 

@Validator(yup.string(), yup.number())
public async sell(token_id: string, selling_price: number) {
    try { 
        const token = await this.Ctx.ERC721Token.get(token_id);
        const t = new ArtCollection(token)
 /**  * price is a custom asset
      attribute to set the price of a non-fungible token in the
      marketplace  */
        t.price =  selling_price;
 /**  * on_sale_flag is a
      custom asset attribute that maintains non-fungible token selling status in the
      marketplace  */
        t.on_sale_flag = true;
        await this.Ctx.ERC721Token.updateToken(t);
        let msg = `Token ID : '${token_id}' has been posted for selling in the marketplace'`;
        return {msg}
        } catch(error) {
            throw new Error(error.message);
    }
}

NFT SDK 메소드

액세스 제어 관리 방법

NFT SDK는 액세스 제어 기능을 제공합니다. 일부 메소드는 토큰의 Token Admin 또는 Account Owner에 의해서만 호출될 수 있습니다. 이 기능을 사용하면 의도한 사용자만 작업을 수행할 수 있습니다. 무단 액세스로 인해 오류가 발생합니다. 액세스 제어 기능을 사용하려면 ../lib/erc721-auth 모듈에서 Authorization 클래스를 임포트합니다.
import { ERC721Authorization } from '../lib/erc721-auth';
checkAuthorization
이 방법을 사용하여 작업에 액세스 제어 검사를 추가합니다. 이것은 비동기 함수입니다. 대부분의 자동 생성 방법에는 액세스 제어가 포함됩니다. 특정 토큰 메소드는 토큰의 ERC721Admin 또는 Account Owner에 의해서만 실행되거나 계정이 여러 개인 사용자의 경우 MultipleAccountOwner에 의해서만 실행될 수 있습니다. checkAuthorization 메소드는 Authorization 클래스의 일부이며, Ctx 객체를 통해 액세스합니다. 액세스 제어 매핑은 다음 텍스트에 표시된 대로 ../lib/constant.ts 파일에 설명되어 있습니다. ../lib/constant.ts 파일을 편집하여 액세스 제어를 수정할 수 있습니다. 고유의 액세스 제어를 사용하거나 액세스 제어를 사용 안함으로 설정하려면 자동으로 생성된 제어기 메소드 및 사용자 정의 메소드에서 액세스 제어 코드를 제거합니다.
export const TOKENACCESS = {
  ADMIN: {
    isUserTokenAdmin: ['Admin', 'MultipleAccountOwner'],
    addAdmin: ['Admin'],
    removeAdmin: ['Admin'],
    getAllAdmins: ['Admin'],
  },
  TOKEN: {
    save: ['Admin'],
    getAllTokens: ['Admin'],
    get: ['Admin'],
    update: ['Admin'],
    getDecimals: ['Admin'],
    getTokensByName: ['Admin'],
    addRoleMember: ['Admin'],
    removeRoleMember: ['Admin'],
    isInRole: ['Admin', 'AccountOwner'],
    getTotalMintedTokens: ['Admin'],
    getNetTokens: ['Admin'],
  },
  ROLE: {
    getAccountsByRole: ['Admin'],
    getUsersByRole: ['Admin'],
  },
  TRANSACTION: {
    deleteTransactions: ['Admin'],
  },
  ACCOUNT: {
    createAccount: ['Admin'],
    getAllAccounts: ['Admin'],
    getAccountsByUser: ['Admin', 'MultipleAccountOwner'],
    getAccount: ['Admin', 'AccountOwner'],
    history: ['Admin', 'AccountOwner'],
    getAccountTransactionHistory: ['Admin', 'AccountOwner'],
    getAccountBalance: ['Admin', 'AccountOwner'],
    getAccountOnHoldBalance: ['Admin', 'AccountOwner'],
    getOnHoldIds: ['Admin', 'AccountOwner'],
  },
  ERC721ADMIN: {
    isUserTokenAdmin: ['Admin'],
    addAdmin: ['Admin'],
    removeAdmin: ['Admin'],
    getAllAdmins: ['Admin'],
  }, 
  ERC721TOKEN: {
    getAllTokens: ['Admin'],
    getAllTokensByUser: ['Admin', 'AccountOwner'],
    get: ['Admin', TOKEN_OWNER],
    getTokensByName: ['Admin'],
    addRoleMember: ['Admin'],
    removeRoleMember: ['Admin'],
    isInRole: ['Admin', 'AccountOwner'],
    totalSupply: ['Admin'],
    totalNetSupply: ['Admin'],
    history: ['Admin'],
  },
  ERC721ROLE: {
    getAccountsByRole: ['Admin'],
    getUsersByRole: ['Admin'],
  },
  ERC721TRANSACTION: {
    deleteTransactions: ['Admin'],
  },
  ERC721ACCOUNT: {
    createAccount: ['Admin'],
    getAllAccounts: ['Admin'],
    getAccountsByUser: ['Admin', 'MultipleAccountOwner'],
    history: ['Admin', 'AccountOwner'],
    getAccountTransactionHistory: ['Admin', 'AccountOwner'],
    getAccountTransactionHistoryWithFilters: ['Admin', 'AccountOwner'],
    balanceOf: ['Admin', 'MultipleAccountOwner'],
  }
}
Ctx.ERC721Auth.checkAuthorization(classFuncName: string, ...args)
매개변수:
  • classFuncName: string - ../lib/constant.ts 파일에 설명된 대로 클래스와 메소드 사이의 맵 값입니다.
  • ...args - args[0]가 'TOKEN' 상수를 사용하고 args[1]가 accountId 매개변수를 사용하여 AccountOwner에 대한 액세스 제어 검사를 추가하는 변수 인수입니다. MultipleAccountOwner에 대한 액세스 제어 검사를 추가하기 위해 args[1]는 orgId 매개변수를 사용하고 args[2]는 userId 매개변수를 사용합니다.
반환값:
  • 성공하면 약속이다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예를 들면 다음과 같습니다.

Admin 액세스 

await this.Ctx.ERC721Auth.checkAuthorization('ADMIN.addAdmin', 'TOKEN');

AccountOwner 액세스 

await this.Ctx.ERC721Auth.checkAuthorization('ACCOUNT.getAccountBalance', 'TOKEN', accountId);

MultipleAccountOwner 액세스 

await this.Ctx.ERC721Auth.checkAuthorization('ADMIN.isUserTokenAdmin', 'TOKEN', orgId, userId);
isUserTokenAdmin
이 메소드는 함수 호출자가 Token Admin인 경우 부울 값 true를 반환합니다. 그렇지 않으면 메소드가 false를 반환합니다. 이 기능은 비동기 정적 함수입니다. 
Ctx.ERC721Auth.isUserTokenAdmin(orgId: string, userId: string)
매개변수:
  • orgId - 현재 네트워크 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 부울 응답 및 오류 메시지(오류가 발생한 경우)
예제:

await this.Ctx.Auth.isUserTokenAdmin('Org1MSP', 'user1');

{"result":false}
addAdmin
이 메소드는 사용자를 토큰 체인 코드의 Token Admin로 추가합니다. 
Ctx.ERC721Admin.addAdmin(orgId: string, userId: string)
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 토큰 체인 코드의 Token Admin로 추가된 사용자에 대한 세부정보를 나열하는 메시지입니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Admin.addAdmin(orgId, userId)

{"msg": "Successfully added Admin (orgId: Org1MSP, userId: user1)"}
removeAdmin
이 메소드는 토큰 체인 코드의 Token Admin인 사용자를 제거합니다. 
Ctx.ERC721Admin.removeAdmin(orgId: string, userId: string)
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 토큰 체인 코드의 Token Admin로 제거된 사용자에 대한 세부정보를 나열하는 메시지입니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Admin.RemoveAdmin(orgId, userId)

{"msg": "Successfully removed Admin (orgId: Org1MSP, userId: user1)"}
getAllAdmins
이 메소드는 모든 Token Admin 사용자 목록을 반환합니다. 
Ctx.ERC721Admin.getAllAdmins()
매개변수:
  • 없음
반환값:
  • 성공 시 모든 Token Admin 사용자 목록이 표시됩니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Admin.getAllAdmins()

{
    "admins": [
        {
            "orgId": "Org1MSP",
            "userId": "admin"
        }
    ]
}

토큰 구성 관리 방법

토큰 구성 관리 방법은 ERC-721 표준을 기반으로 합니다. 토큰 구성 관리 메소드를 사용하려면 ../lib/erc721-token 모듈에서 Token 클래스를 임포트합니다.

totalSupply
이 메소드는 총 연동된 NFT 수를 반환합니다. 이것은 비동기 함수입니다.
Ctx.ERC721Token.totalSupply()
매개변수:
  • 없음
반환값:
  • 성공 시 총 순 토큰(숫자 데이터 유형)입니다. 오류 시 오류 메시지와 함께 반환됩니다.
예제:

await this.Ctx.ERC721Token.totalSupply(tokenAsset);

2000
get
이 메소드는 지정된 토큰 객체가 상태 데이터베이스에 있는 경우 해당 객체를 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.get(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 토큰 자산의 JSON 객체를 포함하는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부
예제:

await this.Ctx.ERC721Token.get(tokenId);

{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "transferredBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "transferredDate": "2022-04-05T09:28:30.000Z",
    "isBurned": false,
    "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
    "price": 100,
    "on_sale_flag": true
}
isTokenType
이 메소드는 지정된 ID의 토큰 자산이 존재하는지 여부를 나타냅니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.isTokenType(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 지정된 ID의 토큰 자산이 존재하는 경우 true로 약속합니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.isTokenType(tokenId);

true
createToken
이 메소드는 토큰을 생성하고 해당 속성을 상태 데이터베이스에 저장합니다. 이 메소드는 minter 롤을 가진 사용자만 호출할 수 있습니다. 이것은 비동기 함수입니다.
Ctx.ERC721Token.createToken(token: <Instance of Token Class>)
매개변수:
  • token: <Instance of Token Class> - 생성할 토큰 자산입니다.
반환값:
  • 성공 시 토큰 세부정보가 포함된 약속 메시지입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.createToken(tokenAsset);

{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "isBurned": false,
    "tokenUri": "\"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg\"",
    "price": 100,
    "on_sale_flag": false
}
updateToken
이 메소드는 토큰 속성을 업데이트합니다. 이 메소드는 토큰의 소유자 또는 생성자만 호출할 수 있습니다. 토큰 자산이 생성된 후에는 토큰 소유자만 토큰 사용자정의 속성을 업데이트할 수 있습니다. 사용자가 토큰 소유자이자 토큰 생성자인 경우 TokenDesc 속성도 업데이트할 수 있습니다. 토큰 메타데이터를 업데이트할 수 없습니다. 특정 등록 정보만 업데이트하려는 경우에도 이 메소드에 모든 토큰 등록 정보를 전달해야 합니다. 이것은 비동기 함수입니다. 
Ctx.ERC721Token.updateToken(token: <Instance of Token Class>)
매개변수:
  • token: <Instance of Token Class> - 업데이트할 토큰 자산입니다.
반환값:
  • 성공 시 토큰 세부정보가 포함된 약속 메시지입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.updateToken(tokenAsset)

{
    "metadata": {
        "painting_name": "Mona_Lisa",
        "description": "Mona Lisa Painting",
        "image": "monalisa.jpeg",
        "painter_name": "Leonardo_da_Vinci"
    },
    "assetType": "otoken",
    "tokenId": "monalisa",
    "tokenName": "artcollection",
    "tokenDesc": "token description",
    "symbol": "ART",
    "tokenStandard": "erc721+",
    "tokenType": "nonfungible",
    "tokenUnit": "whole",
    "behaviors": [
        "indivisible",
        "singleton",
        "mintable",
        "transferable",
        "burnable",
        "roles"
    ],
    "roles": {
        "minter_role_name": "minter"
    },
    "mintable": {
        "max_mint_quantity": 20000
    },
    "owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "createdBy": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "creationDate": "2022-04-05T08:30:42.000Z",
    "isBurned": false,
    "tokenUri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
    "price": 100,
    "on_sale_flag": true
}
getByRange
이 메소드는 내부적으로 패브릭 getStateByRange 메소드를 호출합니다. 지정된 ID를 가진 자산이 원장에서 반환되더라도 이 메소드는 자산을 호출자 자산 유형으로 변환합니다. 이 기능은 비동기 정적 함수입니다. 
@validator(yup.string(), yup.string())
public async getDigiCurrGetByRange(startId: string, endId: string) {
   return await this.Ctx.ERC721TOken.getByRange(startId, endId, PaintingNft);
}
Ctx.ERC721Token.getByRange(startId: string, endId: string, tokenClassReference?: <Instance of Token Class> )
매개변수:
  • startId: string - 범위의 시작 키입니다. 이 키는 범위에 포함됩니다.
  • endId: string - 범위의 끝 키입니다. 이 키는 범위에서 제외됩니다.
  • tokenClassReference: <Instance of Token Class> - 작업할 토큰 자산입니다.
반환값:
  • 성공 시 <Token Class> 배열이 있는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
반환 값 예제:
[
  {
      "metadata":{
         "painting_name":"Mona_Lisa",
         "description":"Mona Lisa Painting",
         "image":"monalisa.jpeg",
         "painter_name":"Leonardo_da_Vinci"
      },
      "assetType":"otoken",
      "tokenId":"monalisa",
      "tokenName":"artcollection",
      "tokenDesc":"token description",
      "symbol":"ART",
      "tokenStandard":"erc721+",
      "tokenType":"nonfungible",
      "tokenUnit":"whole",
      "behaviors":[
         "indivisible",
         "singleton",
         "mintable",
         "transferable",
         "burnable",
         "roles"
      ],
      "roles":{
         "minter_role_name":"minter"
      },
      "mintable":{
         "max_mint_quantity":20000
      },
      "owner":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
      "createdBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
      "transferredBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
      "creationDate":"2022-04-05T08:30:42.000Z",
      "transferredDate":"2022-04-05T09:28:30.000Z",
      "isBurned":false,
      "tokenUri":"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
      "price":100,
      "on_sale_flag":true
   }
]
history
이 메소드는 지정된 토큰에 대한 내역을 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.history(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 약속 내역이 지정된 토큰에 대한 이터레이터를 질의합니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
반환 값 예제:
[
   {
      "trxId":"e17a3154d5271be0492cbc7c12390b3480fec5a792d1cb1083e5335de56ebbd9",
      "timeStamp":1622614032,
      "isDelete":false,
      "value":{
         "metadata":{
            "painting_name":"Mona_Lisa",
            "description":"Mona Lisa Painting",
            "image":"monalisa.jpeg",
            "painter_name":"Leonardo_da_Vinci"
         },
         "assetType":"otoken",
         "tokenId":"monalisa",
         "tokenName":"artcollection",
         "tokenDesc":"token description",
         "symbol":"ART",
         "tokenStandard":"erc721+",
         "tokenType":"nonfungible",
         "tokenUnit":"whole",
         "behaviors":[
            "indivisible",
            "singleton",
            "mintable",
            "transferable",
            "burnable",
            "roles"
         ],
         "roles":{
            "minter_role_name":"minter"
         },
         "mintable":{
            "max_mint_quantity":20000
         },
         "owner":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
         "createdBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
         "creationDate":"2022-04-05T08:30:42.000Z",
         "isBurned":false,
         "tokenUri":"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
         "price":100,
         "on_sale_flag":"true"
      }
   },
   {
      "trxId":"dbcc4da410ad4d4a80996f090b313240f3f3d08aa2b5086afa8d0921f7b4c1e5",
      "timeStamp":1622643853,
      "isDelete":false,
      "value":{
         "metadata":{
            "painting_name":"Mona_Lisa",
            "description":"Mona Lisa Painting",
            "image":"monalisa.jpeg",
            "painter_name":"Leonardo_da_Vinci"
         },
         "assetType":"otoken",
         "tokenId":"monalisa",
         "tokenName":"artcollection",
         "tokenDesc":"token description",
         "symbol":"ART",
         "tokenStandard":"erc721+",
         "tokenType":"nonfungible",
         "tokenUnit":"whole",
         "behaviors":[
            "indivisible",
            "singleton",
            "mintable",
            "transferable",
            "burnable",
            "roles"
         ],
         "roles":{
            "minter_role_name":"minter"
         },
         "mintable":{
            "max_mint_quantity":20000
         },
         "owner":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
         "createdBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
         "transferredBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
         "creationDate":"2022-04-05T08:30:42.000Z",
         "transferredDate":"2022-04-05T09:28:30.000Z",
         "isBurned":false,
         "tokenUri":"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg",
         "price":100,
         "on_sale_flag":true
      }
   }
]
getAllTokens
이 메소드는 상태 데이터베이스에 저장된 모든 토큰 자산을 반환합니다. 이 방법은 Berkeley DB SQL 서식 있는 쿼리를 사용하며 원격 Oracle Blockchain Platform 네트워크에 연결된 경우에만 호출할 수 있습니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.getAllTokens()
매개변수:
  • 없음
반환값:
  • 성공 시 모든 토큰 자산에 대한 약속입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.getAllTokens();

{
   "returnCode":"Success",
   "error":"",
   "result":{
      "txid":"98e0a0a115803d25b843d630e6b23c435a192a03eb0a301fc9375f05da49a8b2",
      "payload":[
         "           "{
            "metadata":{
               "painting_name":"Mona_Lisa",
               "description":"Mona Lisa Painting",
               "image":"monalisa.jpeg",
               "painter_name":"Leonardo_da_Vinci"
            },
            "assetType":"otoken",
            "tokenId":"monalisa",
            "tokenName":"artcollection",
            "tokenDesc":"token description",
            "symbol":"ART",
            "tokenStandard":"erc721+",
            "tokenType":"nonfungible",
            "tokenUnit":"whole",
            "behaviors":[
               "indivisible",
               "singleton",
               "mintable",
               "transferable",
               "burnable",
               "roles"
            ],
            "roles":{
               "minter_role_name":"minter"
            },
            "mintable":{
               "max_mint_quantity":20000
            },
            "owner":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "createdBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate":"2022-04-05T08:30:42.000Z",
            "isBurned":false,
            "tokenUri":"\"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg\"",
            "price":100,
            "on_sale_flag":false
         }"       "
      ],
      "encode":"JSON"
   }
}
getAllTokensByUser
이 메소드는 지정된 계정 ID가 소유한 모든 토큰을 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.getAllTokensByUser(accountId: string)
매개변수:
  • accountId: string - 계정의 ID입니다.
반환값:
  • 성공 시 약속 기록이 지정된 계정에 대한 이터레이터를 질의합니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
반환 값 예제:
{
   "returnCode":"Success",
   "error":"",
   "result":{
      "txid":"98e0a0a115803d25b843d630e6b23c435a192a03eb0a301fc9375f05da49a8b2",
      "payload":[
         "           "{
            "metadata":{
               "painting_name":"Mona_Lisa",
               "description":"Mona Lisa Painting",
               "image":"monalisa.jpeg",
               "painter_name":"Leonardo_da_Vinci"
            },
            "assetType":"otoken",
            "tokenId":"monalisa",
            "tokenName":"artcollection",
            "tokenDesc":"token description",
            "symbol":"ART",
            "tokenStandard":"erc721+",
            "tokenType":"nonfungible",
            "tokenUnit":"whole",
            "behaviors":[
               "indivisible",
               "singleton",
               "mintable",
               "transferable",
               "burnable",
               "roles"
            ],
            "roles":{
               "minter_role_name":"minter"
            },
            "mintable":{
               "max_mint_quantity":20000
            },
            "owner":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "createdBy":"oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "creationDate":"2022-04-05T08:30:42.000Z",
            "isBurned":false,
            "tokenUri":"\"https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg\"",
            "price":100,
            "on_sale_flag":false
         }"       "
      ],
      "encode":"JSON"
   }
ownerOf
이 메소드는 지정된 토큰의 소유자의 계정 ID를 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.ownerOf(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 지정된 토큰 ID에 대한 약속 내역 질의 이터레이터를 반환합니다. 오류가 발생하면 오류 메시지와 함께 거부됩니다.
반환 값 예제:
{"owner": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d"}
tokenUri
이 메소드는 지정된 토큰에 대한 URI를 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.tokenUri(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 지정된 토큰 ID에 대한 약속 내역 질의 이터레이터를 반환합니다. 오류가 발생하면 오류 메시지와 함께 거부됩니다.
반환 값 예제:
{"uri": "https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg"}
getTokenUri
이 메소드는 지정된 토큰에 대한 URI를 반환합니다. 이 기능은 비동기 정적 함수입니다.
Ctx.ERC721Token.getTokenUri(tokenId: string)
매개변수:
  • tokenId: string - 토큰의 ID입니다.
반환값:
  • 성공 시 지정된 토큰 ID에 대한 약속 내역 질의 이터레이터를 반환합니다. 오류가 발생하면 오류 메시지와 함께 거부됩니다.
반환 값 예제:
{"tokenUri": https://bafybeid6pmpp62bongoip5iy2skosvyxh3gr7r2e35x3ctvawjco6ddmsq\\ .ipfs.infura-ipfs.io/?filename=MonaLisa.jpeg"}
symbol
이 메소드는 토큰 클래스의 기호를 반환합니다.
Ctx.ERC721Token.symbol()
매개변수:
  • 없음
반환값:
  • 성공 시 토큰 기호가 있는 JSON 객체입니다.
반환 값 예제:
{"symbol": "PNT"}

계정 관리 방법

generateAccountId
이 메소드는 멤버쉽 서비스 제공자 ID(orgId)와 사용자 이름 또는 전자메일 ID(userId)를 연결한 다음 SHA-256 해시를 생성하여 구성된 계정 ID를 반환합니다. 
Ctx.ERC721Account.generateAccountId(orgId: string, userId: string)
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 생성된 계정 ID가 있는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Account.generateAccountId(orgId, userId)

oaccount~a0a60d54ba9e2ff349737d292ea10ebd9cc8f1991c11443c19d20aea299a9507
createAccount
이 메소드는 지정된 사용자 및 토큰에 대한 계정을 생성합니다. 언제든지 토큰을 보유할 모든 사용자에 대해 계정을 만들어야 합니다. 계정은 사용자가 보유한 NFT 수를 추적합니다. 토큰 관련 작업을 완료하려면 네트워크에 계정이 있어야 합니다. 사용자당 하나의 NFT 계정만 생성할 수 있습니다.

계정 ID는 영숫자 문자 집합으로, 앞에 oaccount~이 붙고 그 뒤에 현재 네트워크 조직에 있는 사용자의 멤버쉽 서비스 제공자 ID(orgId)에 대한 SHA-256 해시, 인스턴스 소유자 또는 인스턴스에 로그인한 사용자의 사용자 이름 또는 전자 메일 ID(userId) 및 상수 문자열 nft가 붙습니다. 이 메소드는 체인 코드의 Token Admin로만 호출할 수 있습니다. 

Ctx.ERC721Account.createAccount(orgId: string, userId: string, tokenType: string)
매개변수:
  • orgId: string - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId: string - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • tokenType: string - 지원되는 토큰 유형은 nonfungible뿐입니다.
반환값:
  • 성공 시 새 계정 객체에 대한 약속입니다. 오류 발생 시 오류 메시지가 있는 거부
예제:

await this.Ctx.ERC721Account.CreateAccount(orgId, userId, tokenType)

{
    "assetType": "oaccount",
    "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "userId": "admin",
    "orgId": "Org1MSP",
    "tokenType": "nonfungible",
    "noOfNfts": 0
}
getAllAccounts
이 메소드는 모든 계정 목록을 반환합니다. 이 방법은 Berkeley DB SQL 서식 있는 쿼리를 사용하며 원격 Oracle Blockchain Platform 네트워크에 연결된 경우에만 호출할 수 있습니다.
Ctx.ERC721Account.getAllAccounts()
매개변수:
  • 없음
반환값:
  • 성공 시 모든 계정을 나열하는 JSON 객체가 포함된 약속입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
반환 값 예제:
[
    {
        "key": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "valueJson": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }   
    }
]
history
이 메소드는 지정된 계정에 대한 계정 내역 세부정보의 배열을 반환합니다.
Ctx.ERC721Account.history(accountId: string)
매개변수:
  • accountId: string - 계정의 ID입니다.
반환값:
  • 성공 시 지정된 계정에 대한 계정 내역 세부정보를 포함하는 map[string]interface{} 배열입니다. 계정 데이터는 맵의 value 키 아래에 표시됩니다. 오류 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Account.history(accountId)

[
    {
        "trxId": "6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
        "timeStamp": 1649151044,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "a605f1fa62e511c2945fce5437f983a5e70ec814b82520d3ecd2d81e3ecf53a3",
        "timeStamp": 1649151022,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 2
        }
    },
    {
        "trxId": "ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timeStamp": 1649150910,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timeStamp": 1649149545,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 0
        }
    },
    {
        "trxId": "e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timeStamp": 1649147442,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 1
        }
    },
    {
        "trxId": "d2d1f9c898707ae831e9361bc25da6369eac37b10c87dc04d18d6f3808222f08",
        "timeStamp": 1649137534,
        "value": {
            "assetType": "oaccount",
            "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
            "userId": "admin",
            "orgId": "Org1MSP",
            "tokenType": "nonfungible",
            "noOfNfts": 0
        }
    }
]
getUserByAccountId
이 메소드는 지정된 계정에 대한 사용자 세부정보를 반환합니다.
Ctx.ERC721Account.getUserByAccountId(accountId: string)
매개변수:
  • accountId: string - 계정의 ID입니다.
반환값:
  • 성공 시 다음 속성에 사용자 세부정보를 포함하는 JSON 객체:
    • orgId - 현재 네트워크 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
    • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Account.getUserByAccountById(accountId)

{
  "userId": "admin",
  "orgId": "Org1MSP"
}
getAccountWithStatusByUser
이 메소드는 계정 상태를 포함하여 지정된 계정에 대한 사용자 세부정보를 반환합니다. 이 메소드는 체인 코드의 Token Admin 또는 계정의 Account Owner로만 호출할 수 있습니다. 
Ctx.ERC721Account.getAccountWithStatusByUser(orgId, userId)
매개변수:
  • orgId - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 다음 속성을 포함하는 JSON 계정 객체:
  • accountId - 사용자 계정의 ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • orgId - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • tokenType - 계정이 보유하는 토큰의 유형입니다.
  • noOfNfts - 계정이 보유한 총 NFT 수입니다.
  • bapAccountVersion - 내부용 계정 객체 매개변수입니다.
  • status - 사용자 계정의 현재 상태입니다.
  • 오류 시 오류 메시지가 포함된 nil이 아닌 객체입니다.
예제:

await this.Ctx.ERC721Account.getAccountWithStatusByUser(orgId, userId)

{
  "bapAccountVersion": 0,
  "assetType": "oaccount",
  "status": "active",
  "accountId": "oaccount~cc301bee057f14236a97d434909ec1084970921b008f6baab09c2a0f5f419a9a",
  "userId": "idcqa",
  "orgId": "appdev",
  "tokenType": "nonfungible",
  "noOfNfts": 0
}
getAccountByUser
이 메소드는 지정된 계정에 대한 사용자 세부정보를 반환합니다. 이 메소드는 체인 코드의 Token Admin 또는 계정의 Account Owner로만 호출할 수 있습니다. 
Ctx.ERC721Account.getAccountByUser(orgId, userId)
매개변수:
  • orgId - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
반환값:
  • 성공 시 다음 속성을 포함하는 JSON 계정 객체:
  • accountId - 사용자 계정의 ID입니다.
  • userId - 사용자의 사용자 이름 또는 전자메일 ID입니다.
  • orgId - 현재 조직에 있는 사용자의 멤버쉽 서비스 제공자(MSP) ID입니다.
  • tokenType - 계정이 보유하는 토큰의 유형입니다.
  • noOfNfts - 계정이 보유한 총 NFT 수입니다.
  • 오류 시 오류 메시지가 포함된 nil이 아닌 객체입니다.
예제:

await this.Ctx.ERC721Account.getUserByAccountById(orgId, userId)

{
    "assetType": "oaccount",
    "accountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
    "userId": "admin",
    "orgId": "Org1MSP",
    "tokenType": "nonfungible",
    "noOfNfts": 0
}
balanceOf
이 메소드는 지정된 사용자가 보유한 총 NFT 수를 반환합니다.
Ctx.ERC721Account.balanceOf(accountId: string)
매개변수:
  • accountId: string - 사용자의 계정 ID입니다.
반환값:
  • 성공 시 현재 NFT 수의 JSON 객체입니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Account.balanceOf(accountId)

{"totalNfts": 0}

역할 관리 방법

addRoleMember
이 메소드는 지정된 사용자 및 토큰에 롤을 추가합니다. 계정 ID는 연결된 멤버쉽 서비스 제공자 ID(orgId)의 SHA-256 해시와 사용자 이름 또는 전자메일 ID(userId)를 생성하여 구성됩니다. 이것은 비동기 함수입니다. 
Ctx.ERC721Token.addRoleMember(role: string, accountId: string)
매개변수:
  • role: string - 지정된 사용자에 추가할 롤의 이름입니다. mintable 및 burnable 동작은 사양 파일의 minter_role_name 및 burner_role_name 속성에 해당합니다.
  • accountId: string - 작업할 계정 ID입니다.
반환값:
  • 성공 시 추가된 역할 및 계정 ID를 포함하는 메시지가 있는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부
예제:

await this.Ctx.ERC721Token.addRoleMember(role, accountId);

{"msg": "Successfully added role 'minter' to Account Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}
removeRoleMember
이 메소드는 지정된 사용자 및 토큰에서 롤을 제거합니다. 계정 ID는 연결된 멤버쉽 서비스 제공자 ID(orgId)의 SHA-256 해시와 사용자 이름 또는 전자메일 ID(userId)를 생성하여 구성됩니다. 이것은 비동기 함수입니다. 
Ctx.ERC721Token.removeRoleMember(role: string, accountId: string)
매개변수:
  • role: string - 지정된 사용자로부터 제거할 롤의 이름입니다. mintable 및 burnable 동작은 사양 파일의 minter_role_name 및 burner_role_name 속성에 해당합니다.
  • accountId: string - 작업할 계정 ID입니다.
반환값:
  • 성공 시 제거된 역할 및 계정 ID를 포함하는 메시지가 있는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부
예제:

await this.Ctx.ERC721Token.removeRoleMember(role, accountId);

{"msg": "Successfully removed role 'minter' from Account Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1)"}
isInRole
이 메소드는 사용자 및 토큰에 지정된 롤이 있는지 여부를 나타내는 부울 값을 반환합니다. 계정 ID는 연결된 멤버쉽 서비스 제공자 ID(orgId)의 SHA-256 해시와 사용자 이름 또는 전자메일 ID(userId)를 생성하여 구성됩니다. 이것은 비동기 함수입니다. 
Ctx.ERC721Token.isInRole(role: string, accountId: string)
매개변수:
  • role: string - 지정된 사용자를 확인할 역할의 이름입니다. mintable 및 burnable 동작은 사양 파일의 minter_role_name 및 burner_role_name 속성에 해당합니다.
  • accountId: string - 작업할 계정 ID입니다.
반환값:
  • 성공 시 지정된 계정 ID에 대한 역할이 있는 경우 true인 약속입니다. 그렇지 않은 경우 false입니다. 오류 발생 시 오류 메시지가 있는 거부
예제:

await this.Ctx.ERC721Token.isInRole(role, accountId, tokenAsset)

{"result": "true"}
getAccountsByRole
이 메소드는 지정된 롤에 대한 모든 계정 ID 목록을 반환합니다.
Ctx.ERC721Role.getAccountsByRole(roleName: string)
매개변수:
  • roleName: string - 검색할 롤의 이름입니다.
반환값:
  • 성공 시 JSON 계정 ID 배열입니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Role.getAccountsByRole(userRole)

{
    "accounts": [
        "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d"
    ]
}
getUsersByRole
이 메소드는 지정된 롤에 대한 모든 사용자 목록을 반환합니다.
Ctx.ERC721Role.getUsersByRole(userRole: string)
매개변수:
  • role: string - 검색할 역할의 이름입니다.
반환값:
  • 성공 시 사용자 객체의 JSON 배열입니다. 각 객체는 사용자 ID 및 조직 ID를 포함합니다. 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Role.getUsersByRole(userRole)

{
    "users": [
        {
            "userId": "admin",
            "orgId": "Org1MSP"
        }
    ]
}

트랜잭션 내역 관리 방법

getAccountTransactionHistory
이 메소드는 지정된 계정에 대한 트랜잭션 내역 세부정보의 배열을 반환합니다.
Ctx.ERC721Account.getAccountTransactionHistory(accountId: string)
매개변수:
  • accountId: string - 계정의 ID입니다.
반환값:
  • 성공 시 JSON 형식의 계정 트랜잭션 객체 배열:
    • transactionId - 트랜잭션의 ID입니다.
    • transactedAccount - 트랜잭션이 발생한 계정입니다.
    • transactionType - 트랜잭션 유형입니다.
    • timestamp - 트랜잭션의 시간입니다.
    • noOfNfts - 호출자 계정의 잔액입니다.
    • 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Account.GetAccountTransactionHistory(accountId)

[
    {
        "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
        "timestamp": "2022-04-05T09:30:44.000Z",
        "tokenId": "monalisa1",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "BURN"
    },
    {
        "transactionId": "otransaction~a605f1fa62e511c2945fce5437f983a5e70ec814b82520d3ecd2d81e3ecf53a3",
        "timestamp": "2022-04-05T09:30:22.000Z",
        "tokenId": "monalisa1",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    },
    {
        "transactionId": "otransaction~ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timestamp": "2022-04-05T09:28:30.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "CREDIT"
    },
    {
        "transactionId": "otransaction~cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timestamp": "2022-04-05T09:05:45.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "DEBIT"
    },
    {
        "transactionId": "otransaction~e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timestamp": "2022-04-05T08:30:42.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    }
]
getAccountTransactionHistoryWithFilters
이 메소드는 PageSize, Bookmark, startTime 및 endTime로 필터링된 지정된 사용자에 대한 계정 트랜잭션 내역을 반환합니다. 이 메소드는 원격 Oracle Blockchain Platform 네트워크에 접속된 경우에만 호출할 수 있습니다. 
async getAccountTransactionHistoryWithFilters(orgId: string, userId: string, filters?: Filters)
매개변수:
  • accountId: string - 계정의 ID입니다.
  • filters: object - pageSize, bookmark, startTime 및 endTime의 네 가지 속성을 포함하는 Filter 클래스의 객체입니다. 비어 있으면 모든 레코드가 반환됩니다. PageSize 속성은 반환할 레코드 수를 결정합니다. PageSize가 0이면 기본 페이지 크기는 20입니다. Bookmark 속성은 반환할 레코드의 시작 인덱스를 결정합니다. 자세한 내용은 Hyperledger Fabric 설명서를 참조하십시오. StartTime 및 EndTime 속성은 RFC-3339 형식으로 지정해야 합니다.
반환값:
  • 성공 시 JSON 형식의 계정 트랜잭션 객체 배열:
    • transactionId - 트랜잭션의 ID입니다.
    • transactedAccount - 트랜잭션이 발생한 계정입니다.
    • transactionType - 트랜잭션 유형입니다.
    • timestamp - 트랜잭션의 시간입니다.
    • noOfNfts - 호출자 계정의 잔액입니다.
    • 오류 발생 시 오류 메시지가 포함된 nil이 아닌 오류 객체입니다.
예제:

await this.Ctx.ERC721Account.getAccountTransactionHistoryWithFilters(accountId, filters)

[
    {
        "transactionId": "otransaction~ca4c07bf04240345de918cbf1f4f3da4b4d0ab044c5b8bea94343e427d9ed4e7",
        "timestamp": "2022-04-05T09:28:30.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "CREDIT"
    },
    {
        "transactionId": "otransaction~cfb52ffc8c34c7fd86210fcf8c5f53d9f92a056c45ed3a33671d638020c1f9cb",
        "timestamp": "2022-04-05T09:05:45.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba",
        "transactionType": "DEBIT"
    },
    {
        "transactionId": "otransaction~e7747b3001a170f88688620956320e9402e1dd8edad8afb4818a08a34647337c",
        "timestamp": "2022-04-05T08:30:42.000Z",
        "tokenId": "monalisa",
        "transactedAccount": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
        "transactionType": "MINT"
    }
]
getTransactionById
이 메소드는 Transaction 자산의 내역을 반환합니다. 
Ctx.ERC721Transaction.getTransactionById(transactionId: string)
매개변수:
  • transactionId: string - 트랜잭션 자산의 ID입니다.
예제:

await this.Ctx.ERC721Transaction.getTransactionById(transactionId)

{
    "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
    "history": [
        {
            "trxId": "6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
            "timeStamp": 1649151044,
            "value": {
                "assetType": "otransaction",
                "transactionId": "otransaction~6ffd0d94f234c12444a5d5aa559563b59dff4d2280b573fea956dc632bdaf5d4",
                "tokenId": "monalisa1",
                "fromAccountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
                "toAccountId": "",
                "triggeredByAccountId": "oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d",
                "transactionType": "BURN",
                "timestamp": "2022-04-05T09:30:44.000Z",
            }
        }
    ]
}
deleteHistoricalTransactions
이 메소드는 상태 데이터베이스에서 지정된 날짜보다 오래된 트랜잭션을 삭제합니다.
Ctx.ERC721Transaction.deleteTransactions(timeToExpiration: Date)
매개변수:
  • timeToExpiration: Date - 날짜 및 시간입니다. 지정된 시간보다 오래된 트랜잭션이 삭제됩니다.
예제:

await this.Ctx.ERC721Transaction.deleteTransactions(timeToExpiration)

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "62ad6753cf2bfa54816b4c2f0ea325478b1cb1b84f8e13e6742c00f277310081",
        "payload": {
            "msg": "Successfuly deleted transaction older than date: Fri Apr 08 2022 00:00:00 GMT+0000 (Coordinated Universal Time).",
            "transactions": [
                "otransaction~e687531b71d943da2fb129638784fb93a96e7698013dfc51c8c6bf4f5f797059",
                "otransaction~18446adf59b669e12990a1cf3ea0a7a15764f967fa694cf263aee0cd5a21d952",
                "otransaction~5560d4b5e0b0d0b9a6e97dcd7f81241a5daf56497a7b6819c6a55cebacc106f2",
                "otransaction~f0a0a64ec1a0c92ac732706dd75ffbd3feecd9c48fc79e42c551485edf0542cb"
            ]
        },
        "encode": "JSON"
    }
}

토큰 동작 관리 - 민트 가능한 동작

getMaxMintQuantity
이 메소드는 토큰의 최대 민트 가능 수량을 반환합니다. max_mint_quantity 동작이 사양 파일에 구성되지 않은 경우 기본값은 0이며 토큰 수를 무제한으로 지정할 수 있습니다. 
Ctx.ERC721Token.getMaxMintQuantity(token: <Instance of Token Class>)
매개변수:
  • token: <Instance of Token Class> - 작업할 토큰 자산입니다.
반환값:
  • 성공 시 숫자 데이터 유형의 최대 연동 가능 토큰 수량입니다. 오류 시 오류 메시지와 함께 반환됩니다.
예제:

await this.Ctx.ERC721Token.getMaxMintQuantity(tokenAsset);

20000
getTotalMintedTokens
이 메소드는 지정된 토큰에 대해 시스템에서 사용 가능한 총 주석 처리된 토큰 수를 반환합니다. 사용 가능한 토큰의 순 수는 총 연동 토큰 수에서 연소된 토큰 수를 뺀 값입니다. 이것은 비동기 함수입니다.
Ctx.ERC721Token.getTotalMintedTokens()
매개변수:
  • token: <Instance of Token Class> - 작업할 토큰 자산입니다.
반환값:
  • 성공 시 숫자 데이터 유형의 총 민트 토큰입니다. 오류 시 오류 메시지와 함께 반환됩니다.
예제:

await this.Ctx.ERC721Token.getTotalMintedTokens(tokenAsset);

4000

토큰 동작 관리 - 전송 가능한 동작

safeTransferFrom
이것은 비동기 함수입니다. 이 메소드는 호출자에서 다른 계정으로 지정된 NFT의 소유권을 이전합니다. 이 메소드는 다음 검증을 포함합니다.
  • 토큰이 존재하며 레코딩되지 않습니다.
  • 발신자 계정과 수령인 계정이 있으며 동일한 계정이 아닙니다.
  • 발신자 계정은 토큰을 소유합니다.
  • 함수의 호출자가 발신자입니다.
Ctx.ERC721Token.safeTransferFrom(fromAccountId: string, toAccountId: string, token: <Instance of Token Class>, data?: string)
매개변수:
  • fromAccountId: string - 현재 조직에 있는 발신자의 계정 ID입니다.
  • toAccountId: string - 현재 조직에 있는 수신자의 계정 ID입니다.
  • token: <Instance of Token Class> - 전송할 토큰 자산입니다.
  • data: string - 트랜잭션에 저장할 선택적 추가 정보입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 성공 메시지가 있는 약속입니다. 계정 ID의 접두어는 oaccount~입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.safeTransferFrom(fromAccountId, toAccountId, tokenAsset, data);

{"msg": "Successfully transferred NFT token: 'monalisa' from Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin) to Account-Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1)"}
transferFrom
이것은 비동기 함수입니다. 이 방법은 지정된 NFT의 소유권을 발신자 계정에서 수신자 계정으로 이전합니다. 호출자는 정확한 파라미터를 전달해야 합니다. 이 메소드는 토큰 소유자뿐만 아니라 모든 사용자가 호출할 수 있습니다. 이 메소드는 다음 검증을 포함합니다.
  • 토큰이 존재하며 레코딩되지 않습니다.
  • 발신자 계정과 수령인 계정이 있으며 동일한 계정이 아닙니다.
  • 발신자 계정은 토큰을 소유합니다.
Ctx.ERC721Token.transferFrom(fromAccountId: string, toAccountId: string, token: <Instance of Token Class>)
매개변수:
  • fromAccountId: string - 현재 조직에 있는 발신자의 계정 ID입니다.
  • toAccountId: string - 현재 조직에 있는 수신자의 계정 ID입니다.
  • token: <Instance of Token Class> - 전송할 토큰 자산입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 성공 메시지가 있는 약속입니다. 계정 ID의 접두어는 oaccount~입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
\예제:

await this.Ctx.ERC721Token.transferFrom(fromAccountId, toAccountId, tokeAsset, data);

{"msg": "Successfully transferred NFT token: 'monalisa' from Account-Id: oaccount~ec32cff8635a056f3dda3da70b1d6090d61f66c6a170c4a95fd008181f729dba (Org-Id: Org1MSP, User-Id: user1) to Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}

토큰 동작 관리 - 굽기 가능 동작

burn
이 메소드는 호출자 계정에서 지정된 NFT를 비활성화하거나 레코딩합니다. 이 메서드의 호출자에 계정이 있어야 합니다.The caller of this method must have an account. 토큰 사양 파일에 burnable 동작이 포함되어 있지 않으면 토큰을 구울 수 없습니다. 사양 파일의 roles 섹션에 burner_role_name 속성이 지정되지 않은 경우 토큰 소유자가 토큰을 구울 수 있습니다. burner_role_name 등록 정보가 roles 섹션에 지정된 경우 토큰의 채굴자(생성자)이기도 한 버너 역할을 지정한 사용자가 토큰을 레코딩할 수 있습니다. 이것은 비동기 함수입니다. 
Ctx.ERC721Token.burn(token: <Instance of Token Class>)
매개변수:
  • token: <Instance of Token Class> - 레코딩할 토큰 자산입니다.
반환값:
  • 성공 시 계정 세부정보가 포함된 성공 메시지가 있는 약속입니다. 오류 발생 시 오류 메시지가 있는 거부입니다.
예제:

await this.Ctx.ERC721Token.burn(tokenAsset);

{msg": "Successfully burned NFT token: 'monalisa1' from Account-Id: oaccount~42e89f4c72dfde9502814876423c6da630d466e87436dd1aae201d347ad1288d (Org-Id: Org1MSP, User-Id: admin)"}