NDID Smart Contract

tendermint ABCI app

Note

Test this app with command below

TENDERMINT_ADDRESS=http:https://localhost:45000 go test -v

Add new validator (For testing)

get PubKey from pub_key.data in priv_validator.json

curl -s 'localhost:45000/broadcast_tx_commit?tx="val:PubKey"'

Prerequisites

Go version >= 1.9.2
- Install Go by following installation instructions.
- Set GOPATH environment variable (https://github.com/golang/go/wiki/SettingGOPATH)

Tendermint 0.19.5

mkdir -p $GOPATH/src/github.com/tendermint
cd $GOPATH/src/github.com/tendermint
git clone https://github.com/tendermint/tendermint.git
cd tendermint
git checkout v0.19.5
make get_tools
make get_vendor_deps
make install

Setup

Get dependency (tendermint ABCI)

cd $GOPATH/src/github.com/ndidplatform/smart-contract/abci
dep ensure

Create a directory for the project

mkdir -p $GOPATH/src/github.com/ndidplatform/smart-contract

Clone the project

git clone https://github.com/ndidplatform/smart-contract.git $GOPATH/src/github.com/ndidplatform/smart-contract

Run IdP node

Run ABCI server

cd $GOPATH/src/github.com/ndidplatform/smart-contract

DB_NAME=IdP_DB go run abci/server.go tcp:https://127.0.0.1:46000

Run tendermint

cd $GOPATH/src/github.com/ndidplatform/smart-contract

tendermint --home ./config/tendermint/IdP unsafe_reset_all && tendermint --home ./config/tendermint/IdP node --consensus.create_empty_blocks=false

Run RP node

Run ABCI server

cd $GOPATH/src/github.com/ndidplatform/smart-contract

DB_NAME=RP_DB go run abci/server.go tcp:https://127.0.0.1:46001

Run tendermint

cd $GOPATH/src/github.com/ndidplatform/smart-contract

tendermint --home ./config/tendermint/RP unsafe_reset_all && tendermint --home ./config/tendermint/RP node --consensus.create_empty_blocks=false

Run AS node

Run ABCI server

cd $GOPATH/src/github.com/ndidplatform/smart-contract

DB_NAME=AS_DB go run abci/server.go tcp:https://127.0.0.1:46001

Run tendermint

cd $GOPATH/src/github.com/ndidplatform/smart-contract

tendermint --home ./config/tendermint/AS unsafe_reset_all && tendermint --home ./config/tendermint/AS node --consensus.create_empty_blocks=false

Run in Docker

Required

Docker CE Install docker
docker-compose Install docker-compose

Build

docker-compose -f docker/docker-compose.build.yml build

Run

docker-compose -f docker/docker-compose.yml up

IMPORTANT NOTE

You must start IDP, RP and AS nodes in order to run the platform.
After starting BOTH nodes, please wait for
```
Commit
Commit
```
to show in the first terminal (go run abci ...) of both processes before starting api processes.
When IDP node and RP node run on separate machines, please edit seeds in config/tendermint/{RP or IdP}/config/config.toml to match address of another machines.

Technical details to connect with `api`

Interact with api in BASE64 format data.

Broadcast tx format

functionName|parameter|nonce|base64(sign(param+nonce))|nodeID

Query format

functionName|parameter

Create transaction function

InitNDID

Parameter

{
  "node_id": "NDID",
  "public_key": "-----BEGIN RSA PUBLIC KEY-----\nMIIBCgKCAQEA30i6deo6vqxPdoxA9pUpuBag/cVwEVWO8dds5QDfu/z957zxXUCY\nRxaiRWGAbOta4K5/7cxlsqI8fCvoSyAa/B7GTSc3vivK/GWUFP+sQ/Mj6C/fgw5p\nxK/+olBzfzLMDEOwFRbnYtPtbWozfvceq77fEReTUdBGRLak7twxLrRPNzIu/Gqv\nn5AR8urXyF4r143CgReGkXTTmOvHpHu98kCQSINFuwBB98RLFuWdVwkrHyzaGnym\nQu+0OR1Z+1MDIQ9WlViD1iaJhYKA6a0G0O4Nns6ISPYSh7W7fI31gWTgHUZN5iTk\nLb9t27DpW9G+DXryq+Pnl5c+z7es/7T34QIDAQAB\n-----END RSA PUBLIC KEY-----\n"
}

Expected Output

log: "success"

RegisterNode

Parameter

Posible role is RP,IdP and AS

{
  "node_id": "IdP1",
  "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwx9oT44DmDRiQJ1K0b9Q\nolEsrQ51hBUDq3oCKTffBikYenSUQNimVCsVBfNpKhZqpW56hH0mtgLbI7QgZGj9\ncNBMzSLMolltw0EerF0Ckz0Svvie1/oFJ1a0Cf4bdKKW6wRzL+aFVvelmNlLoSZX\noCpxUPQq7SMLoYEK1c+e3l3H0bfh6TAVt7APOQEFhXy9MRt83oVSAGW36gdNEksm\nz1WIT/C1XcHHVwCIJGSdZw5F6Y2gBjtiLsiFtpKfxQAPwBvDi7uS0PUdN7YQ/G69\nb0FgoE6qivDTqYfr80Y345Qe/qPGDvfne7oA8DIbRV+Kd5s4tFn/cC0Wd+jvrZJ7\njwIDAQAB\n-----END PUBLIC KEY-----\n",
  "master_public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArdcKj/gAetVyg6Nn2lDi\nm/UJYQsQCav60EVbECm5EVT8WgnpzO+GrRyBtxqWUdtGar7d6orLh1RX1ikU7Yx2\nSA8Xlf+ZDaCELba/85Nb+IppLBdPywixgumoto9G9dDGSnPkHAlq5lXXA1eeUS7j\niU1lf37lwTZaO0COAuu8Vt9GcwYPh7SSf4/eXabQGbo/TMUVpXX1w5N1A07Qh5DG\nr/ZKzEE9/5bJJJRS635OA2T4gIY9XRWYiTxtiZz6AFCxP92Cjz/sNvSc/Cuvwi15\nycS4C35tjM8iT5djsRcR+MJeXyvurkaYgMGJTDIWub/A5oavVD3VwusZZNZvpDpD\nPwIDAQAB\n-----END PUBLIC KEY-----\n",
  "node_name": "IdP Number 1 from ...",
  "role": "IdP",
  "max_ial": 3,
  "max_aal": 3
}

Expected Output

log: "success"

RegisterMsqDestination

Parameter

{
  "users": [
    {
      "hash_id": "���\u0010fV+�{��DD�F�;Hָ�`��椼q\u0017���",
      "ial": 3
    }
  ],
  "node_id": "IdP1"
}

Expected Output

log: "success"

AddAccessorMethod

Parameter

{
  "accessor_id": "TestAccessorID",
  "accessor_type": "TestAccessorType",
  "accessor_key": "TestAccessorKey",
  "commitment": "TestCommitment"
}

Expected Output

log: "success"

RegisterServiceDestination

Parameter

{
  "service_id": "statement",
  "node_id": "AS1",
  "service_name": "Bank statement",
  "min_ial": 1.1,
  "min_aal": 1.2
}

Expected Output

log: "success"

RegisterMsqAddress

Parameter

{
  "node_id": "IdP1",
  "ip": "192.168.3.99",
  "port": 8000
}

Expected Output

log: "success"

CreateRequest

Parameter

{
  "request_id": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6",
  "min_idp": 1,
  "min_aal": 1,
  "min_ial": 1,
  "timeout": 259200,
  "data_request_list": null,
  "message_hash": "hash('Please allow...')"
}

Expected Output

log: "success"

CreateIdpResponse

Parameter

{
  "request_id": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6",
  "aal": 3,
  "ial": 3,
  "status": "accept",
  "signature": "signature",
  "accessor_id": "TestAccessorID",
  "identity_proof": "Magic"
}

Expected Output

log: "success"

SignData

Parameter

{
  "node_id": "AS1",
  "request_id": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6",
  "signature": "sign(data,asKey)"
}

Expected Output

log: "success"

SetNodeToken

Parameter

{
  "node_id": "RP1",
  "amount": 100
}

Expected Output

log: "success"

AddNodeToken

Parameter

{
  "node_id": "RP1",
  "amount": 111.11
}

Expected Output

log: "success"

ReduceNodeToken

Parameter

{
  "node_id": "RP1",
  "amount": 61.11
}

Expected Output

log: "success"

SetPriceFunc

Parameter

{
  "func": "CreateRequest",
  "price": 99.99
}

Expected Output

log: "success"

CloseRequest

Parameter

{
  "requestId": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6"
}

Expected Output

log: "success"

TimeOutRequest

Parameter

{
  "requestId": "ef6f4c9c-818b-42b8-8904-3d97c4c11111"
}

Expected Output

log: "success"

AddNamespace

Parameter

{
  "namespace": "CID",
  "description": "Citizen ID"
}

Expected Output

log: "success"

DeleteNamespace

Parameter

{
  "namespace": "Tel"
}

Expected Output

log: "success"

UpdateNode

Parameter

{
  "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArdcKj/gAetVyg6Nn2lDi\nm/UJYQsQCav60EVbECm5EVT8WgnpzO+GrRyBtxqWUdtGar7d6orLh1RX1ikU7Yx2\nSA8Xlf+ZDaCELba/85Nb+IppLBdPywixgumoto9G9dDGSnPkHAlq5lXXA1eeUS7j\niU1lf37lwTZaO0COAuu8Vt9GcwYPh7SSf4/eXabQGbo/TMUVpXX1w5N1A07Qh5DG\nr/ZKzEE9/5bJJJRS635OA2T4gIY9XRWYiTxtiZz6AFCxP92Cjz/sNvSc/Cuvwi15\nycS4C35tjM8iT5djsRcR+MJeXyvurkaYgMGJTDIWub/A5oavVD3VwusZZNZvpDpD\nPwIDAQAB\n-----END PUBLIC KEY-----\n",
  "master_public_key": ""
}

Expected Output

log: "success"

UpdateValidator

Parameter

{
  "public_key": "5/6rEo7aQYq31J32higcxi3i8xp9MG/r5Ho5NemwZ+g=",
  "power": 0
}

Expected Output

log: "success"

Query function

GetNodePublicKey

Parameter

{
  "node_id": "RP1"
}

Expected Output

{
  "public_key": "-----BEGIN RSA PUBLIC KEY-----\nMIIBCgKCAQEAwCB4UBzQcnd6GAzPgbt9j2idW23qKZrsvldPNifmOPLfLlMusv4E\ncyJf4L42/aQbTn1rVSu1blGkuCK+oRlKWmZEWh3xv9qrwCwov9Jme/KOE98zOMB1\n0/xwnYotPadV0de80wGvKT7OlBlGulQRRhhgENNCPSxdUlozrPhrzGstXDr9zTYQ\noR3UD/7Ntmew3mnXvKj/8+U48hw913Xn6btBP3Uqg2OurXDGdrWciWgIMDEGyk65\nNOc8FOGa4AjYXzyi9TqOIfmysWhzKzU+fLysZQo10DfznnQN3w9+pI+20j2zB6gg\npL75RjZKYgHU49pbvjF/eOSTOg9o5HwX0wIDAQAB\n-----END RSA PUBLIC KEY-----\n"
}

GetMsqDestination

Parameter

{
  "hash_id": "���\u0010fV+�{��DD�F�;Hָ�`��椼q\u0017���",
  "min_ial": 3,
  "min_aal": 3,
}

Expected Output

{
  "node": [
    {
      "id": "IdP1",
      "name": "IdP Number 1 from ..."
    },
    {
      "id": "IdP2",
      "name": ""
    }
  ]
}

GetAccessorMethod

Parameter

{
  "accessor_id": "TestAccessorID"
}

Expected Output

{
  "accessor_type": "TestAccessorType",
  "accessor_key": "TestAccessorKey",
  "commitment": "TestCommitment"
}

GetServiceDestination

Parameter

{
  "service_id": "statement"
}

Expected Output

{
  "node_id": [
    "AS1"
  ]
}

GetMsqAddress

Parameter

{
  "node_id": "IdP1"
}

Expected Output

{
  "ip": "192.168.3.99",
  "port": 8000
}

GetRequest

Parameter

{
  "requestId": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6"
}

Expected Output

{
  "status": "pending",
  "is_closed": false,
  "is_timed_out": true,
  "messageHash": "hash('Please allow...')"
}

GetRequestDetail

Parameter

{
  "requestId": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6"
}

Expected Output

{
  "request_id": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6",
  "min_idp": 1,
  "min_aal": 1,
  "min_ial": 1,
  "timeout": 259200,
  "data_request_list": null,
  "message_hash": "hash('Please allow...')",
  "responses": [
    {
      "request_id": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6",
      "aal": 3,
      "ial": 3,
      "status": "accept",
      "signature": "signature",
      "accessor_id": "TestAccessorID",
      "identity_proof": "Magic"
    }
  ]
}

GetNodeToken

Parameter

{
  "node_id": "RP1"
}

Expected Output

{
  "amount": 100
}

GetPriceFunc

Parameter

{
  "func": "CreateRequest"
}

Expected Output

{
  "price": 99.99
}

GetUsedTokenReport

Parameter

{
  "node_id": "AS1"
}

Expected Output

[
  {
    "method": "RegisterServiceDestination",
    "price": 1,
    "data": ""
  },
  {
    "method": "SignData",
    "price": 1,
    "data": "ef6f4c9c-818b-42b8-8904-3d97c4c520f6"
  }
]

GetServiceDetail

Parameter

{
  "service_id": "statement",
  "node_id": "AS1"
}

Expected Output

{
  "service_name": "Bank statement",
  "min_ial": 1.1,
  "min_aal": 1.2
}

GetNamespaceList

Parameter

Expected Output

[
  {
    "namespace": "CID",
    "description": "Citizen ID"
  }
]

Name		Name	Last commit message	Last commit date
Latest commit History 200 Commits
abci		abci
config/tendermint		config/tendermint
docker		docker
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
abci_test.go		abci_test.go

License

0x0d01/smart-contract

Folders and files

Latest commit

History

Repository files navigation

NDID Smart Contract

Note

Add new validator (For testing)

Prerequisites

Setup

Run IdP node

Run RP node

Run AS node

Run in Docker

Build

Run

IMPORTANT NOTE

Technical details to connect with api

Broadcast tx format

Query format

Create transaction function

InitNDID

Parameter

Expected Output

RegisterNode

Parameter

Expected Output

RegisterMsqDestination

Parameter

Expected Output

AddAccessorMethod

Parameter

Expected Output

RegisterServiceDestination

Parameter

Expected Output

RegisterMsqAddress

Parameter

Expected Output

CreateRequest

Parameter

Expected Output

CreateIdpResponse

Parameter

Expected Output

SignData

Parameter

Expected Output

SetNodeToken

Parameter

Expected Output

AddNodeToken

Parameter

Expected Output

ReduceNodeToken

Parameter

Expected Output

SetPriceFunc

Parameter

Expected Output

CloseRequest

Parameter

Expected Output

TimeOutRequest

Parameter

Expected Output

AddNamespace

Parameter

Expected Output

DeleteNamespace

Parameter

Expected Output

UpdateNode

Parameter

Expected Output

UpdateValidator

Parameter

Expected Output

Query function

Technical details to connect with `api`

Packages