> For the complete documentation index, see [llms.txt](https://docs.gnoswap.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gnoswap.io/contracts/gov/governance/governance_propose.gno.md).

# governance\_propose.gno

{% embed url="<https://github.com/gnoswap-labs/gnoswap/blob/d9d34bd345a36c3eedaccf491c6615b0ac4168cd/contract/r/gnoswap/gov/governance/v1/governance_propose.gno>" %}

## ProposeCommunityPoolSpend

```go
func ProposeCommunityPoolSpend(
	cur realm,
	title string,
	description string,
	to address,
	tokenPath string,
	amount int64
) int64
```

ProposeCommunityPoolSpend creates a CommunityPoolSpend proposal with the provided data. The transfer is attempted when an approved proposal executes.

The community-pool balance is checked at execution, not proposal creation.

> **Halt check:** reverts while the Governance halt scope is active.

#### Parameters

| Name          | Type    | Description                                                                  |
| ------------- | ------- | ---------------------------------------------------------------------------- |
| `cur`         | realm   | Current realm context; callers use cross(cur) when crossing into this realm. |
| `title`       | string  | The title of the proposal.                                                   |
| `description` | string  | The description of the proposal.                                             |
| `to`          | address | A valid address to receive the spent token.                                  |
| `tokenPath`   | string  | A registered token path.                                                     |
| `amount`      | int64   | A strictly positive amount in the token's smallest unit.                     |

#### Return Values

| Name         | Type  | Description             |
| ------------ | ----- | ----------------------- |
| `proposalId` | int64 | The ID of the proposal. |

[source](https://github.com/gnoswap-labs/gnoswap/blob/d9d34bd345a36c3eedaccf491c6615b0ac4168cd/contract/r/gnoswap/gov/governance/proxy.gno#L43)

## ProposeParameterChange

```go
func ProposeParameterChange(
	cur realm,
	title string,
	description string,
	numToExecute int64,
	executions string
) int64
```

ProposeParameterChange creates a ParameterChange proposal with the provided data.

> **Halt check:** reverts while the Governance halt scope is active, except for halt-recovery proposals that only target the halt realm.

#### Parameters

| Name           | Type   | Description                                                                  |
| -------------- | ------ | ---------------------------------------------------------------------------- |
| `cur`          | realm  | Current realm context; callers use cross(cur) when crossing into this realm. |
| `title`        | string | The title of the proposal.                                                   |
| `description`  | string | The description of the proposal.                                             |
| `numToExecute` | int64  | The number of changes to execute.                                            |
| `executions`   | string | The list of changes to execute.                                              |

#### Return Values

| Name         | Type  | Description             |
| ------------ | ----- | ----------------------- |
| `proposalId` | int64 | The ID of the proposal. |

[source](https://github.com/gnoswap-labs/gnoswap/blob/d9d34bd345a36c3eedaccf491c6615b0ac4168cd/contract/r/gnoswap/gov/governance/proxy.gno#L74)

## ProposeText

```go
func ProposeText(
	cur realm,
	title string,
	description string
) int64
```

ProposeText creates a new text proposal with the provided data.

> **Halt check:** reverts while the Governance halt scope is active.

#### Parameters

| Name          | Type   | Description                                                                  |
| ------------- | ------ | ---------------------------------------------------------------------------- |
| `cur`         | realm  | Current realm context; callers use cross(cur) when crossing into this realm. |
| `title`       | string | The title of the proposal.                                                   |
| `description` | string | The description of the proposal.                                             |

#### Return Values

| Name         | Type  | Description             |
| ------------ | ----- | ----------------------- |
| `proposalId` | int64 | The ID of the proposal. |

[source](https://github.com/gnoswap-labs/gnoswap/blob/d9d34bd345a36c3eedaccf491c6615b0ac4168cd/contract/r/gnoswap/gov/governance/proxy.gno#L14)
