Introduction

The Polymesh Portal is an interface for interacting with an account on the Polymesh Blockchain. It showcases some of the rich features available on Polymesh and is meticulously crafted with a responsive design that seamlessly adapts to different devices, including mobile phones and tablets.

The Authorizations Page acts as a centralized hub for managing permissioned actions. You can view details of incoming and outgoing authorizations pending acceptance or rejection. This feature also enables you to create authorizations for various actions such as the transfer of ticker, transfer of asset ownership, request a key to join the identity, adding relayer paying keys, assignment of portfolio custody to another identity, and more. The Authorizations Page ensures secure and streamlined management of permissioned actions within the Polymesh ecosystem.

The Authorizations Page

Authorizations Card

The Authorizations card shows incoming and outgoing authorization requests for your selected account.
You can see more details then accept or decline them.

Create new Authorization

You can create a new authorization by clicking on the Create New Auth button:

A popup window will appear. First you need to select the authorization type, then fill in the details accordingly: 

Authorization Types

Add Relayer Paying Key

Relayers are used to pay transaction on behalf of your account. This authorization type must be issued by the paying key.
In order to add a relayer paying key, fill in the details as per below:

• Allowance: This is the amount of POLYX you wish to subsidize for the relayer paying key.
• Beneficiary: This is Polymesh key of the beneficiary, on Polymesh Mainnet it begins with 2.

Once all data are filled, click on the Create button then sign the transaction with your wallet.

Become Agent

External agent functionality allows issuers and investors to assign custodians (and other agents) to manage or service assets in specific capacities. Learn more about external agents here.

Permissions

• Full Permissions: Every permission included.
• Full without Agent Permissions: Every permission included, except
• Corporate Action Agent: Permissions to create and manage corporate actions.
• Primary Issuance Agent: Permissions to issue the selected asset.
• Custom Permissions: Custom permissions for a permission group. To create a permission group, follow the instructions here.

Once all data are filled, click on the Create button then sign the transaction with your wallet.

Portfolio Custody

With portfolio custody, you can assign custodianship of a portfolio to another identity. This cleanly separates beneficial ownership of an asset (which always stays under the beneficiaries identity) used for corporate actions, from custodial ownership where another entity may manage those assets on behalf of your beneficiary. Learn more about portfolios and custody here.

Once all data are filled, click on the Create button then sign the transaction with your wallet.

Join Identity

You can request a key to join to your selected identity with a Join Identity authorization.

Enter the target account and an optional expiry date if needed, then click on the Create button and sign the transaction with your wallet. Note that the target account must be unassigned and should not be a part of any existing identity.

Transfer Asset Ownership

You can transfer ownership of your asset to a different identity with this authorization.
This authorization type must be issued by the current owner of the asset.
Enter the target DID, an optional expiry date then select the asset you would like to transfer.

Once all data are filled, click on the Create button then sign the transaction with your wallet.

Transfer Ticker

You can transfer your existing ticker to a different identity with the Transfer Ticker authorization.
This authorization type must be issued by the current owner of the ticker.

Once all data are filled, click on the Create button then sign the transaction with your wallet.

Rotate Primary Key

You can rotate your primary key with your secondary one. Please be aware that funds (including staked funds) do not transfer when swapping, they remain in their respective keys.
You can find further information in this guide: Rotating Keys.