> For the complete documentation index, see [llms.txt](https://i-am-human.gitbook.io/i-am-human-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://i-am-human.gitbook.io/i-am-human-docs/technical-specs/oracle.md).

# Oracle

Technical documentation on how we use an Oracle to validate information before allowing certain SBTs to be minted

We are currently only using an oracle to verify a user's whitelisting status with Fractal prior to allowing the corresponding Face Verification SBT to be issued.

Link to our source code on GitHub [here](https://github.com/near-ndc/gooddollar-oracle).

### Configuration

All default configuraconfigurations areion is available in `default.json` config file. To override these settings a config file `local.jsom` could be used instead.

#### Credentials

Use `near generate-key i-am-human-credentials --networkId mainnet` to generate new credentials. The above command will create a file `~/.near-credentials/mainnet/i-am-human-credentials.json` with required private key.

The `private_key` property from a resulting file could be either passed with environment variable `SIGNING_KEY` or set via configuration file as:

```
  "signer": {
    "credentials": {
      "signingKey": "{{PUT_PRIVATE_KEY_HERE}}"
    }
  }
```

The public key generated in a file `~/.near-credentials/mainnet/i-am-human-credentials.json` is in wrapped format. If the ed25519 base64 encoded public key required (e.g. for i-am-human near contract), it could be obtained after service start from an output (search for text `ED25519 public key (base64 encoded):`)

### Docker

Build docker image `docker build -t gooddollar-oracle . &`

Prepare registry to be used with docker-compose `docker run -d -p 5000:5000 --restart=always --name registry registry:2`

Tag previously built docker image `docker tag gooddollar-oracle:latest localhost:5000/gooddollar-oracle`

Push built tag to registry `docker push localhost:5000/gooddollar-oracle`

Pull & run docker image using docker-compose `docker-compose pull && docker-compose --compatibility up -d`