Comment on page

Admin Manager

Admin Manager contract is owned by Gov contract, and is responsible for executing contract migrations and admin key transfers, which are used in order to execute time sensitive migrations such as Terra's columbus network upgrades.
All operations in admin manager contract can only be executed by submitting and executing a poll on Mirror governance (one of migration_poll or auth_admin_poll).

Config

Key
Type
Description
owner
String
Address of owner of admin manager (Gov contract)
admin_claim_period
u64
The duration of admin privilege delegation to a defined address when AuthorizeClaim occurs.

InstantiateMsg

#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct InstantiateMsg {
pub owner: String,
pub admin_claim_period: u64,
}
Key
Type
Description
owner
String
Address of owner of admin manager (Gov contract)
admin_claim_period
u64
The duration of admin privilege delegation to a defined address when AuthorizeClaim occurs

ExecuteMsg

UpdateOwner

Replaces the owner address of the admin manager contract to a new one
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
UpdateOwner {
owner: String,
}
Key
Type
Description
owner
String
Address of the owner of admin manager
{
"update_owner": {
"owner": "terra1..."
}
}
Key
Type
Description
owner
String
Address of the owner of admin manager

ExecuteMigrations

Contract migration is executed when the Gov contract sends an ExecuteMigrations message.
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
ExecuteMigrations {
migrations: Vec<(String, u64, Binary)>,
},
migrations
Type
Description
String
Address of the current Mirror contract to be migrated
u64
Token code ID of the new contracts
Binary
Migration execution message
{
"execute_migrations": {
"migrations": [
("terra1...", 123, eBdwav...),
("terra1...", 123, eBdwav...)
]
}
}
migrations
Type
Description
String
Address of the current Mirror contract to be migrated
u64
Token code ID of the new contracts
Binary
Migration execution message

AuthorizeClaim

Delegates admin privileges to migrate contracts to a specified address until admin_claim_period ends.
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
AuthorizeClaim {
authorized_addr: String,
},
Key
Type
Description
authorized_addr
String
Address to temporarily delegate the admin privilege to
{
"authorize_claim": {
"authrized_addr": "terra1..."
}
}
Key
Type
Description
authorized_addr
String
Address to temporarily delegate the admin privilege to

ClaimAdmin

Once AuthorizeClaim is executed, the authorized_addr can send this transaction to claim the rights to the admin keys until the admin_claim_period ends.
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
ClaimAdmin {
contract: String,
},
Key
Type
Description
contract
String
Address of contracts that the authorized_addr has right to migrate
{
"claim_admin": {
"contract": "terra1..."
}
}
Key
Type
Description
contract
String
Address of contracts that the authorized_addr has right to migrate

QueryMsg

Config

Returns the configuration of the admin manager contract
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
Config {},
ConfigResponse
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct ConfigResponse {
pub owner: String,
pub admin_claim_period: u64,
}
Key
Type
Description
owner
String
Address of the owner of admin manager contract (Gov contract)
admin_claim_period
String
Length of time which the admin key is claimed and used for (in seconds)
{
"config": {}
}
ConfigResponse
{
"config_response": {
"owner": "terra1...",
"admin_claim_period": 8
}
}
Key
Type
Description
owner
String
Address of the owner of admin manager contract (Gov contract)
admin_claim_period
u64
Length of time which the admin key is claimed and used for (in seconds)

MigrationRecords

Returns the history of execute_migrations records.
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
MigrationRecords {
start_after: Option<u64>, // timestamp (seconds)
limit: Option<u32>,
},
Key
Type
Description
start_after
u64
Optional timestamp to return the migration history from
limit
u32
Max number of migration records to return
Response
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct MigrationRecordResponse {
pub executor: String,
pub time: u64,
pub migrations: Vec<MigrationItem>,
}
Key
Type
Description
executor
String
Address of the migration executor
time
u64
UNIX timestamp of when the migration was executed
migrations
MigrationItem
Migration specific details including migrated contract address, token code ID and binary message used for the migration.
{
"migration_records": {
"start_after": 12341234,
"limit": 8
}
}
Key
Type
Description
start_after
u64
Optional timestamp to return the migration history from
limit
u32
Max number of migration records to return
Response
{
"executor": "terra1...",
"time": 12341234,
"migrations": {
"contract": "terra1...",
"new_code_id": 234,
"msg": "evDw12549..."
}
}
Key
Type
Description
executor
String
Address of the migration executor
time
u64
UNIX timestamp of when the migration was executed
migrations
Vec<MigrationItem>
Migration specific details including migrated contract address, token code ID and binary message used for the migration

AuthRecords

Returns the history of AuthorizeClaim transactions
Rust
JSON
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
AuthRecords {
start_after: Option<u64>, // timestamp (seconds)
limit: Option<u32>,
},
Key
Type
Description
start_after
u64
Optional timestamp of when to return the history from
limit
u32
Max number of records to return
Response
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct AuthRecordResponse {
pub address: String,
pub start_time: u64,
pub end_time: u64,
}
Key
Type
Description
address
String
The address at which the admin key was authorized to
start_time
u64
UNIX timestamp of when the admin_claim_period started
end_time
u64
UNIX timestamp of when the admin_claim_period ended
{
"auth_records": {
"start_after": 12341234,
"limit": 8
}
}
Key
Type
Description
start_after
u64
Optional timestamp of when to return the history from
limit
u32
Max number of records to return
Response
{
"address": "terra1...",
"start_time": 12341234,
"end_time": 12341234
}
Key
Type
Description
address
String
The address which the admin key was authorized to
start_time
u64
UNIX timestamp of when the admin_claim_period started
end_time
u64
UNIX timestamp of when the admin_claim_period ended