Search Apps Documentation Source Content File Folder Download Copy Actions Download State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

README.md

2.52 Kb · 72 lines
Download

Community Pool

GnoSwap community treasury for ecosystem development.

Overview

The community pool holds registered protocol-owned tokens. The emission system routes its configured community-pool share to this address, while other protocol flows may fund it separately. This package exposes a direct, access-controlled transfer operation; it does not store proposal or voting state.

Configuration

  • Emission Allocation: 5% of GNS emissions (default)
  • Transfer Authorization: TransferToken accepts an admin or governance caller while withdrawals are not halted
  • Token Scope: Transfers use registered token paths and the community-pool balance

External governance and transfers

  • Proposal and voting workflows, if used, are implemented by an external governance process.
  • An approved external execution may call TransferToken, but the package itself performs no proposal validation or automatic execution.
  • Successful transfers emit a TransferToken event.

Emergency admin policy

Governance is the recommended normal route for treasury transfers. While governance is not yet mature, admin authorization is retained for emergency-only use.

This restriction is an operational policy, not an on-chain emergency check. The admin can call TransferToken directly without an approved governance proposal. The contract does not verify an emergency or automatically remove admin access when governance matures. Withdrawal-halt and token-transfer checks still apply; emergency admin access does not bypass them.

Key Functions

TransferToken

Directly transfers a registered token to a specified address. The caller must be admin or governance, withdrawals must not be halted, and the normal token transfer validation applies.

Gnoweb

Render("") shows the admin and governance role addresses and the withdrawal halt checked by TransferToken. It does not enumerate token balances or claim a total treasury value. Query a specific registered token with GetBalanceOf(tokenPath). Unsupported paths return 404.

Usage

1// Governance execution, or emergency admin action under the operational policy
2TransferToken(
3    cross(cur),
4    "gno.land/r/gnoswap/gns.GNS",
5    recipientAddr,
6    1000000,
7)

Security

  • Admin-or-governance authorization is required for transfers
  • Withdrawal halt blocks transfers
  • Registered-token and balance validation is enforced by the transfer helper
  • Proposal/voting state is not implemented in this package
  • Event emission provides transfer traceability
  • Multi-token support