Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

Update CDD verification documentation pictures #68

Merged
merged 3 commits into from
Nov 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed docs/02-quickstart/images/alice-balance.png
Binary file not shown.
Binary file added docs/02-quickstart/images/connect_account.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/02-quickstart/images/connect_wallet.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file removed docs/02-quickstart/images/onboarding-landing.png
Binary file not shown.
Binary file removed docs/02-quickstart/images/onboarding-mock-cdd.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/02-quickstart/images/select_cdd_provider.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/02-quickstart/images/verify_identity.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
97 changes: 30 additions & 67 deletions docs/02-quickstart/verification-with-cdd.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,103 +6,66 @@ description: Complete customer due diligence

## Customer Due Diligence (CDD)

Every Polymesh account must pass a **minimal identity verification** before the account is permitted to transact with regulated securities on the network. This minimal verification is called **customer due diligence (CDD)**.
Every Polymesh account must pass a **minimal identity verification** before being permitted to transact on the network. This verification is called **customer due diligence (CDD)**.

Verifying your identity for CDD purposes means working with a CDD service provider. They will verify the information you send and write an identity claim to the chain for you.
Verifying your identity for CDD purposes involves applying through a CDD service provider. They will verify the information you submit and write an identity claim to the blockchain for you.

## Assign account
:::note

When you first create an account it will show as an unassigned key. This means there is no onchain identity associated with it.

![new account](images/new_account.png)

The `Assign` button appears when you hover over an unassigned signing key. The associated link will take you to the account context tab in the Polymath [Mainnet Polymesh](https://dashboard.polymath.network/account) or [Testnet Polymesh](https://testnet-dashboard.polymath.network/account) dashboard. From here, you can select `Create Account` to link to the Polymesh onboarding portal.

![assign account](images/assign.png)

When connecting to Polymath's dashboard for the first time you will be prompted to authorize it to communicate with your Polymesh Wallet. Press `Authorize` in the wallet popup to allow the page to load.

Click the `Create Account` button to bring you to the appropriate onboarding portal.

![Wallet Assign Key To Id](images/dashboard-create-account.png)

:::tip
You can skip accessing Polymath's dashboard by going directly to either of the
following links:

- https://onboarding.polymesh.network/ for Mainnet
- https://testnet-onboarding.polymesh.live/ for Testnet
Everyone who participates in transactions on Polymesh must complete onboarding. This is not a substitution for KYC requirements of regulated assets. Asset issuers will typically enforce additional KYC requirements. Asset issuers cannot circumvent the minimum requirement for a key to be associated with an on-chain identity with a valid CDD claim.

:::

## Complete the Customer Due Diligence process

When connecting to the onboarding portal for the first time you will be prompted to authorize it to communicate with your Polymesh Wallet. Press `Authorize` in the wallet popup to allow the page to connect and then click `I've set up my Polymesh Wallet` to start the process.

![Onboarding landing page](images/onboarding-landing.png)
## Assign Account

Enter your email address, select the kind of Polymesh user you are, accept the privacy policy and click the "Submit" button.
When you first create an account, it will display as an unassigned key, meaning there is no on-chain identity associated with it.

![Onboarding registration](images/onboarding-registration.png)

An email will be sent to your email address with a link for you to log in to the onboarding portal. Open your email and follow the link.

You will be presented with the below screen. Click the `New Application` button.

![Onboarding New Application](images/onboarding-new-application.png)

### Testnet Mock Customer Due Diligence process

(For Mainnet skip to the next [section](#mainnet-customer-due-diligence-process))

On testnet you will be presented with the below screen, allowing you to select the "Polymath Mock CDD" provider. Review the displayed wallet address and confirm it is the account you wish to onboard. If it is not, open the wallet extension and select the account you want to onboard as the primary key associated with your identity.
![new account](images/new_account.png)

When satisfied, select "Polymath Mock CDD" and then "Continue".
If using the Polymesh wallet the `Assign` button appears when you hover over an unassigned signing key. Clicking it will take you to the Polymesh Portal on either the [Polymesh Mainnet](https://portal.polymesh.network/) or [Polymesh Testnet](https://portal.polymesh.live/).

![Choose a CDD Provider - Testnet](images/onboarding-choose-cdd-provider-testnet.png)
![assign account](images/assign.png)

Another email will be sent to the address you logged in with. The email will contain a link allowing you to log into the mock CDD portal, linked to the wallet account you provided. Open the link and complete the form.
When connecting to Polymesh Portal for the first time, you will be prompted to select a wallet to connect. Choose your wallet from the list of available options and authorize the wallet connection to the Portal.

![Mock CDD form](images/onboarding-mock-cdd.png)
![connect wallet](images/connect_wallet.png)

Complete the form with any mock data and click `Submit`. Submitting will initiate onchain actions to add a "decentralized ID" (DID) and a CDD claim to the account. This may take up to a minute to complete.
**Note:** You can also enter a key manually by clicking on 'Manually enter a wallet key.' Manually entered keys that are not stored in the connected wallet only allow view-only functionality. To fully utilize Polymesh, connect a key stored in a supported wallet.

Continue to the [Success](#success) section.
On the next screen, select the wallet address to connect and click 'Proceed.' Once connected, the Portal will display information specific to that key.

### Mainnet Customer Due Diligence process
![connect address](images/connect_account.png)

On Mainnet you will be presented with a screen similar to below, allowing you to select your preferred CDD provider. Review the displayed wallet address and confirm it is the account you wish to onboard. If it is not, open the wallet extension and select the account you want to onboard as the primary key associated with your identity.
## Complete the Customer Due Diligence Process

When satisfied, select your chosen provider and then click "Continue". An email will be sent to your email address with a link to the CDD providers KYC portal. CDD steps will vary from provider to provider. Follow the instructions from the provider to submit your application for review.
Click the `Verify Identity` (or `Complete Onboarding`) button to begin the onboarding process.

![Choose a CDD Provider](images/onboarding-choose-cdd-provider.png)
![Verify Identity](images/verify_identity.png)

Application processing time may vary depending on multiple factors. Please allow 48 hours for processing. You will receive an email confirming the outcome of the CDD process. You can also review the status of your application by visiting https://onboarding.polymesh.network/login
You will be presented with a list of CDD service providers to choose from. Click on the CDD provider's card to proceed with onboarding.

**DO NOT SUBMIT APPLICATIONS TO MULTIPLE PROVIDERS AT THE SAME TIME!**
![Select CDD Provider](images/select_cdd_provider.png)

### Success
Follow the on-screen instructions to onboard with the chosen CDD provider. This will involve being redirected to the CDD providers website or application. Once you complete the onboarding application, the Portal will show a "Pending" status for identity verification.

When you next open the wallet extension you will see a [DID](/docs/introduction/identity/#polymesh-account-what-isare-your-usernames) (long hexadecimal string starting with 0x) associated with your selected account at the top of your wallet with the word **Verified** next to it.
![Identity Verification Pending](images/verify_identity_pending.png)

![Wallet Verified](images/verified.png)
After submitting your application, it may take up to two business days for the provider to verify your identity. You can return to the portal anytime to check if the application has been approved. Clicking on the "Verify Identity" button when the status is pending will display information related to your application.

**Congratulations! You have completed customer due diligence.**
![Existing Application](images/existing_application_found.png)

As a bonus, **on testnet**, your account will automatically be credited with POLYX allowing you to start to transact onchain.
Once the CDD provider completes the verification, you will see a card at the top of the Portal indicating that onboarding is complete.

:::tip
![Onboarding Completed](images/onboarding_completed.png)

Everyone who participates in materially-important transactions on Polymesh must complete customer due diligence (CDD), at a minimum. Asset originators can and usually will augment this minimum requirement with additional KYC requirements but they may not circumvent this minimum requirement.
### Testnet Mock Customer Due Diligence Process

Since we will use the Testnet for exercises as we discover Polymesh, it is recommended that you complete your CDD now.
On the [Testnet instance of the Polymesh Portal](https://portal.polymesh.live/), you will instead see a screen that allows you to select the "MockId [TESTNET]" provider. Selecting this option will automatically create a DID, assign a CDD claim, and seed the account with POLYX tokens for testing without an identity verification process.

:::
![Choose a CDD Provider - Testnet](images/onboarding-choose-cdd-provider-testnet.png)

## Links

- [Polymesh Portal Mainnet](https://portal.polymesh.network)
- [Polymesh Portal Testnet](https://testnet-portal.polymesh.live)
- [Onboarding Mainnet](https://onboarding.polymesh.network/)
- [Onboarding Testnet](https://testnet-onboarding.polymesh.live/)
- [Customer due diligence](/docs/kyc/know-your-customer/)
- [Polymesh Portal Testnet](https://portal.polymesh.live)
- [Customer Due Diligence](/docs/kyc/know-your-customer/)
2 changes: 1 addition & 1 deletion polymesh-docs/primitives/assets/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ subsite: polymesh-docs

Polymesh supports the issuance and management of both fungible and non-fungible native assets.

While each asset type has specific differences in issuance and definition, both fungible and non-fungible assets use the [Settlement](../../settlement/) and [Compliance](../../compliance/) modules consistently. This consistency allows both asset types to share attestations and be settled collectively.
While each asset type has specific differences in issuance and definition, both fungible and non-fungible assets use the [Settlement](../settlement/) and [Compliance](../compliance/) modules consistently. This consistency allows both asset types to share attestations and be settled collectively.

## Asset IDs

Expand Down
Loading