Skip to main content

Client

Cli

A user can query and interact with the GAL module using the CLI.

Query​

The query commands allow users to query GAL state.

novad query gal --help

Claimable​

Claimable returns the amount of equity tokens(snAsset) that can be received for the assets of the address deposited in the zone corresponding to the zone-id.

novad query gal claimable [zone-id] [address]

Example:

novad query gal claimable cosmoshub-1 nova1a2b...

Example Output:

{
    "denom": "snAtom",
    "amount": 1000
}

IcaWithdrawal​

ica-withdrawal returns the amount of pending withdrawal asset of user corresponding to zone-id.

novad query gal ica-withdrawal [zone-id] [address]

Example:

novad query gal pending-withdrawal cosmoshub-1 nova1a2b...

Example Output:

{
    "denom": "uatom",
    "amount": 1000
}

Active Withdrawal​

active-withdrawal returns the amount of active withdrawal asset of user corresponding to zone-id.

novad query gal active-withdrawal [zone-id] [address]

Example:

novad query gal active-withdrawal [zone-id] [address]

Example Output:

{
  "denom": "uatom",
  "amount": 1000
}

Deposit Records​

deposit-records returns the records of deposit for user corresponding to zone-id.

novad query gal deposit-records [zone-id] [address]

Example:

novad query gal deposit-records cosmoshub-1 nova1a2b...

Example Output:

{
  "zoneId": "cosmoshub-1",
  "depositor": "nova1a2b...",
  "records": [
    {
      "claimer": "nova1a2b...",
      "amount": {
        "denom": "uatom",
        "amount": 1000
      },
      "state": 1,
      "oracleVersion": 100,
      "delegateVersion": 124
    }
  ]
}

Delegate Records​

delegate-records returns the records of delegate for user corresponding to zone-id.

novad query gal delegate-records [zone-id] [address]

Example:

novad query gal delegate-records cosmoshub-1 nova1a2b...

Example Output:

{
  "zoneId": "cosmoshub-1",
  "claimer": "nova1a2b...",
  "records": {
    "1":{
      "depositor": "nova1a2b...",
      "amount": {
        "denom": "uatom",
        "amount": 1000
      },
      "state": 1,
      "oracleVersion": 100,
      "delegateVersion": 124
    }
  }
}

Undelegate Records​

undelegate-records returns the records of undelegation for user corresponding to zond-id.

novad query gal undelegate-records [zone-id] [address]

Example:

novad query gal undelegate-records cosmoshub-1 nova1a2b...

Example Output:

{
  "zoneId": "cosmoshub-1",
  "delegator": "nova1a2b...",
  "records": [
    {
      "withdrawer": "nova1a2b...",
      "snAssetAmount": {
        "denom": "snAtom",
        "amount": 1000
      },
      "withdrawAmount": 500,
      "state": 1,
      "oracleVersion": 100,
      "undelegateVersion": 125
    }
  ]
}

Withdraw Records​

withdraw-records returns the records of withdraw for user corresponding to zond-id.

novad query withdraw-records [zone-id] [address]

Example:

novad query withdraw-records cosmoshub-1 nova1a2b...

Example Output:

{
  "zoneId": "cosmoshub-1",
  "withdrawer": "nova1a2b...",
  "records": {
    "1": {
      "Amount": 1000,
      "state": 1,
      "oracleVersion": 1000,
      "withdrawVersion": 1024,
      "CompletionTime": {
        "well": 1000,
        "ext": 1000,
        "loc": {
          "name": "UTC",
          "zone": null,
          "tx": [],
          "extend": null
        }
      }
    }
  }
}

TotalSnAssetSupply​

total-snasset-supply 

novad query total-snasset-supply [zone-id]

Example Output:

{
  "amount": {
    "amount": "0",
    "denom": snuatom,
  }
}

Transaction​

Deposit​

novad tx gal deposit [zone-id] [depositor] [clamier] [amount]

Example:

novad tx gal deposit cosmoshub-1 nova1a2b... nova1a2b... 10000uatom

Delegate​

novad tx gal delegate [zone-id] [sequence]

Example:

novad tx gal delegate cosmoshub-1 1

Pending Undelegate​

novad tx gal pending-undelegate [zone-id] [delegator] [withdrawer] [amount]

Example:

novad tx gal pending-undelegate cosmoshub-1 nova1a2b... nova9a8b... 10000uatom

Undelegate​

novad tx gal undelegate [zone-id] [sequence]

Example:

novad tx gal undelegate cosmoshub-1 1

Withdraw​

novad tx gal withdraw [zone-id] [withdrawer]

Example:

novad tx gal withdraw cosmoshub-1 nova1a2b...

Claim​

novad tx gal claim [zone-id] [claimer-address]

Example:

novad tx gal claim cosmoshub-1 nova1a2b...

IcaWithdraw​

novad tx gal ica-withdraw [zone-id] [ica-transfer-port-id] [ica-transfer-channel-id] [block-time] [sequence]

Example:

novad tx gal ica-withdraw cosmoshub-1 transfer channel-0  1

gRPC​

A user can query the gal module using gRPC endpoints.

Estimate sn-Asset​

The estimate_sn_asset endpoint allows user to calculate the amount of asset if they deposit their asset.

nova.gal.v1.Query/estimate_sn_asset

Claimable Amount​

The claimable_amount endpoint allows user to query the amount of sn-asset they can claim.

nova.gal.v1.Query/claimable_amount

Pending Withdrawal​

The pending_withdrawal endpoint allows user to query the amount of pending withdraw.

nova.gal.v1.Query/pending_withdrawals

Active Withdrawal​

The active_withdrawals endpoint allows user to query the amount of active withdraw.

nova.gal.v1.Query/active_withdrawals

Deposit Records​

The deposit_records endpoint allows user to query the deposit records of user.

nova.gal.v1.Query/deposit_records

Undelegate Records​

The undelegate_records endpoint allows user to query the undelegate records of user.

nova.gal.v1.Query/undelegate_records

Withdraw Records​

The withdraw_records endpoint allows user to query the withdraw records of user.

nova.gal.v1.Query/withdraw_records