ID NODE API
ID NODE API는 Dapp 연동 시 SymID를 발급 혹은 Keystore 생성 하기 위해 제공되는 Dapp Partner API 입니다.
소개
Symverse 블록체인 참여자(DApp)로써 활동하기 위해서는 ID Node를 통해 Keystore를 등록해야 합니다. 참여 하는 방법은 Salt 지갑을 통해 회원가입, BBP 서비스 이용, Partner API 등이 있습니다.
해당 페이지는 Partner API를 통한 Keystore 생성 혹은 등록 방법에 대해 작성하였고, Dapp 서비스 개발 시에 제공되는 Open API 형태입니다.
사전 요구사항
1. 퍼블릭 네트워크 설정
symverse 퍼블릭 네트워크로 크게 Testnet, Mainnet 두가지가 존재합니다.
Testnet은 테스트 전용 네트워크로써 블록체인 내 여러 기능을 테스트 할 수 있습니다. Mainnet은 심버스에서 운영중인 핵심 퍼블릭 네트워크입니다.
API에 호출하기 전에 해당하는 퍼블릭 네트워크를 host로 사용합니다.
2. Secret 키 발급
API를 사용하기 위해서는 Symverse 회사를 통해 Secret (32길이의 랜덤 값)를 발급받으셔야 합니다.
// 예시
SECRET: d139996edf514e7ba7883930c1db8f7b
발급 받은 Secret 를 통해 아래 API 목록을 확인해서 원하는 API 를 호출합니다.
API Spec
블록체인 Keystore 생성 API
POST [host]/caii/d1/{secret}/account/new
Keystore 생성 및 해당 네트워크에 SymID를 등록합니다.
Path Parameters
{
"message": "NewKeystoreReturn",
"result": {
"private_key": "0x99957b9d39dd63c40f8425b2d8e5a70c7b234e24f1aeaf6a34e38837627fc9e8",
"public_key_x": "0x44c7402f600b88416ab9078748504513e8896047835c07bdfdc6a23c81ef9015",
"public_key_y": "0x82763122d34de1aeae7bf47791eeea5f0dd619462bd88ca4b96782a7739f4cae",
"public_key_hash": "0x85a784E634ab7644Ba4A43b7a1455Ba592C11B13",
"txhash": "0x1deeb76d585b77917b39a75866aa9d9b3164c3eb3f55314920fde12a7a87fed8",
"keystore": {
"address": "0002b4611fb9a3740002",
"crypto": {
"cipher": "aes-128-ctr",
"ciphertext": "1674da459ffbf64ed6ad531fb60752407279e8145ff9ede7079727dd53a51df5",
"cipherparams": {
"iv": "7af7d5fa9b6695363e770e094fe6f39a"
},
"kdf": "scrypt",
"kdfparams": {
"dklen": 32,
"n": 262144,
"p": 1,
"r": 8,
"salt": "49b8bab3ef71c945d691a3a2423bb285481d6424cc70a2de3688b2c6496bb64a"
},
"mac": "39f320bbe017fe288be2b7fa56c2a4430834aeb9a7230b267d4b787037fde01a"
},
"id": "c295863a-bf64-4463-9db0-d03ed5dbaa8a",
"version": 3
},
"keystore_passphrase": "u4blGI{9x0MjqiuL"
}
}
블록체인 Keystore 생성 By Public key Hash API
POST [host]/caii/d1/{secret}/account/new/{hash}
Public Key Hash 기반으로 Keystore 생성 및 해당 네트워크에 SymID를 등록합니다.
Path Parameters
{
"message": "NewKeystoreReturn",
"result": {
"private_key": "0x99957b9d39dd63c40f8425b2d8e5a70c7b234e24f1aeaf6a34e38837627fc9e8",
"public_key_x": "0x44c7402f600b88416ab9078748504513e8896047835c07bdfdc6a23c81ef9015",
"public_key_y": "0x82763122d34de1aeae7bf47791eeea5f0dd619462bd88ca4b96782a7739f4cae",
"public_key_hash": "0x85a784E634ab7644Ba4A43b7a1455Ba592C11B13",
"txhash": "0x1deeb76d585b77917b39a75866aa9d9b3164c3eb3f55314920fde12a7a87fed8",
"keystore": {
"address": "0002b4611fb9a3740002",
"crypto": {
"cipher": "aes-128-ctr",
"ciphertext": "1674da459ffbf64ed6ad531fb60752407279e8145ff9ede7079727dd53a51df5",
"cipherparams": {
"iv": "7af7d5fa9b6695363e770e094fe6f39a"
},
"kdf": "scrypt",
"kdfparams": {
"dklen": 32,
"n": 262144,
"p": 1,
"r": 8,
"salt": "49b8bab3ef71c945d691a3a2423bb285481d6424cc70a2de3688b2c6496bb64a"
},
"mac": "39f320bbe017fe288be2b7fa56c2a4430834aeb9a7230b267d4b787037fde01a"
},
"id": "c295863a-bf64-4463-9db0-d03ed5dbaa8a",
"version": 3
},
"keystore_passphrase": "u4blGI{9x0MjqiuL"
}
}
{
"message": "already existed pub_key_hash",
"result": null
}
