# Hackathon Guide

## Introduction

Pop CLI is an all-in-one tool for Polkadot development. It streamlines both chain and smart contract workflows so you can go from idea → demo during a hackathon.

Pop CLI simplifies development with:

* Quick initialization of development environment.
* Project scaffolding from predefined templates.
* Easy launch and management of local development networks.

> See also: [Quickstart Chain Development with Pop CLI (official Polkadot docs)](https://docs.polkadot.com/develop/toolkit/parachains/quickstart/pop-cli/)
>
> For Polkadot SDK–based chains, ensure your local toolchain is ready: [Install Polkadot SDK Dependencies](https://docs.polkadot.com/develop/parachains/install-polkadot-sdk/).

### Contract Development (ink!) <a href="#contract-development" id="contract-development"></a>

Pop CLI introduces experimental support for [ink! v6 smart contracts](https://use.ink/docs/v6) running on [PolkaVM (RISC-V)](https://github.com/paritytech/polkavm) via `pallet-revive`.

#### TL;DR Flow

```bash
# 1) Scaffold (choose provider/template interactively)
pop new contract

# 2) Build your contract
cd my-contract && pop build --release

# 3) Deploy (Pop CLI will run a local network by default; add `--url` to target a remote RPC)
pop up # `pop up --url wss://passet-hub-paseo.dotters.network`

# 4) Interact with your contract (You can secure signing via browser wallet).
pop call contract # `pop call contract  --use-wallet`
```

**Handy Links**

* [ink! docs](https://use.ink/docs/v6)
* [Launch a Chain to Paseo](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-appchains/guides/launch-a-chain/launch-a-chain-to-paseo.md)
* [Your first ink! smart contract](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-smart-contracts/guides/create-a-new-contract.md)
* [Deploy your contract](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-smart-contracts/guides/deploy.md)
* [Call your contract](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-smart-contracts/guides/call-your-contract.md)
* [Securely Sign Transactions from CLI](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-smart-contracts/guides/securely-sign-transactions-from-cli.md)

### Chain Development <a href="#chain-development" id="chain-development"></a>

Build and run a local chain quickly; deploy when ready.

#### TL;DR Flow

```bash
# 1) Scaffold (choose provider/template interactively)
pop new chain

# 2) Build your chain
cd my-chain && pop build --release

# 3) Run a local network (Zombienet config)
pop up network -f ./network.toml
```

Congrats! You’ve spun up a network with your chain running!

```
┌   Pop CLI : Deploy a chain
│
◇  🚀 Network launched successfully - ctrl-c to terminate
│  ⛓️ paseo-local
│       alice:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62551#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/alice/alice.log
│       bob:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62555#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/bob/bob.log
│  ⛓️ local_testnet: 2000
│       collator-01:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62559#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/collator-01/collator-01.log
│
```

#### Other useful commands

```bash
# 4) Interact with your chain (You can secure signing via browser wallet).
pop call chain # `pop call chain  --use-wallet`

# 5) Register the rollup on Paseo or deploy using Polkadot Deployment Portal
pop up
# And follow the interactive guide:
┌   Pop CLI : Deploy a rollup
│
◆  Select your deployment method:
│  ● Polkadot Deployment Portal (https://staging.deploypolkadot.xyz)
│  ○ Register
```

**Handy Links**

* [Launch a Chain in Development](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-appchains/guides/launch-a-chain/running-your-chain.md)
* [Launch a Chain to Paseo](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-appchains/guides/launch-a-chain/launch-a-chain-to-paseo.md)
* [Deploy a chain with Polkadot Deployment Portal](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-appchains/guides/launch-a-chain/deploy-a-chain-polkadot-deployment-portal.md)
* [Securely Sign Transactions from CLI](https://github.com/r0gue-io/pop-docs/blob/main/pop-cli-for-appchains/guides/securely-sign-transactions-from-cli.md)

### Support & Contribute

* Questions / help? Join our [Telegram](https://web.telegram.org/k/#@pop_support)
* Follow updates on [X](https://x.com/onpopio)
* Found a *bug* or have a *feature request*? [Open an issue](https://github.com/r0gue-io/pop-cli/issues)
* *Want to contribute?* Check out open issues tagged [`good first issue`](https://github.com/r0gue-io/pop-cli/issues?q=is%3Aissue+state%3Aopen+label%3A%22good+first+issue%22)

<figure><img src="https://869155420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo5SXLburcDkUfYooDW9B%2Fuploads%2Fgit-blob-7cc027e933b991ff0eeef542c145bfc5bf4ae9ce%2Fonpopio-hackathon.png?alt=media" alt="Pop CLI"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.onpop.io/welcome/hackathon-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
