{"id":13564384,"url":"https://github.com/palomachain/paloma","last_synced_at":"2025-04-07T22:07:23.119Z","repository":{"id":37070240,"uuid":"460893504","full_name":"palomachain/paloma","owner":"palomachain","description":"The fast blockchain messenger protocol","archived":false,"fork":false,"pushed_at":"2024-10-11T15:41:49.000Z","size":14534,"stargazers_count":290,"open_issues_count":10,"forks_count":135,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-29T17:12:56.085Z","etag":null,"topics":["arbitrum","binance-smart-chain","blockchain","cometbft","cosmos-sdk","ethereum","kava","optimism","solana"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/palomachain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-18T14:54:59.000Z","updated_at":"2024-10-17T18:07:38.000Z","dependencies_parsed_at":"2023-12-19T07:53:27.582Z","dependency_job_id":"f1318d38-e05c-4bcd-85f9-faca19a068fb","html_url":"https://github.com/palomachain/paloma","commit_stats":{"total_commits":475,"total_committers":20,"mean_commits":23.75,"dds":0.6231578947368421,"last_synced_commit":"66fb3ff90a08ae1699e068490d4e69f21f622401"},"previous_names":[],"tags_count":77,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palomachain%2Fpaloma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palomachain%2Fpaloma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palomachain%2Fpaloma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palomachain%2Fpaloma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/palomachain","download_url":"https://codeload.github.com/palomachain/paloma/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247737769,"owners_count":20987718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arbitrum","binance-smart-chain","blockchain","cometbft","cosmos-sdk","ethereum","kava","optimism","solana"],"created_at":"2024-08-01T13:01:30.460Z","updated_at":"2025-04-07T22:07:23.106Z","avatar_url":"https://github.com/palomachain.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg alt=\"Paloma\" src=\"https://github.com/palomachain/paloma/blob/master/assets/Paloma_black.png\" /\u003e\n\u003c/div\u003e\n\n\u003e A Golang implementation of Paloma Chain, a decentralized, automation network for smart contracts\n\u003e deployed in the Cosmos, EVM, Solana, and Polkadot networks.\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/palomachain/paloma/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"License: Apache-2.0\" src=\"https://img.shields.io/github/license/palomachain/paloma.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.repostatus.org/#wip\"\u003e\n    \u003cimg alt=\"Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.\" src=\"https://img.shields.io/badge/repo%20status-WIP-yellow.svg?style=flat-square\" /\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"Go Version\" src=\"https://img.shields.io/github/go-mod/go-version/palomachain/paloma?logo=paloma\" /\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/palomachain/paloma\"\u003e\n    \u003cimg src=\"https://pkg.go.dev/badge/github.com/palomachain/paloma.svg\" alt=\"Go Reference\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/palomachain/paloma\"\u003e\n    \u003cimg alt=\"Go report card\" src=\"https://goreportcard.com/badge/github.com/palomachain/paloma\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/palomachain/paloma/actions/workflows/ci-test.yml\"\u003e\n    \u003cimg alt=\"Code Coverage\" src=\"https://github.com/palomachain/paloma/actions/workflows/ci-test.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/palomachain/paloma/actions/workflows/release.yml\"\u003e\n    \u003cimg alt=\"Code Coverage\" src=\"https://github.com/palomachain/paloma/actions/workflows/release.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"Lines of code\" src=\"https://img.shields.io/tokei/lines/github/palomachain/paloma\" /\u003e\n\u003c/div\u003e\n\nPaloma is the fastest, secure crosschain communications blockchain. For Crosschain Software engineers who want simultaneous control of multiple, cross-chain-deployed, smart contracts, Paloma is decentralized and consensus-driven message delivery. Paloma is fast state awareness, low cost state computation, and a powerful attestation system. Polama blockchain enables scalable, crosschain, smart contract execution with any data source.\n\n## Table of Contents\n\n- [Talk To Us](#talk-to-us)\n- [International Community](#international-community)\n- [Releases](#releases)\n- [Active Networks](#active-networks)\n- [Join a network](#join-an-active-network)\n- [Contributing](CONTRIBUTING.md)\n\n## Talk to us\n\nWe have active, helpful communities on Twitter and Telegram.\n\n- [Twitter](https://twitter.com/paloma_chain)\n- [Telegram](https://t.me/palomachain)\n- [Discord](https://discord.gg/HtUvgxvh5N)\n- [Forum](https://forum.palomachain.com/)\n\n## International Community\n\n- [Bengali README](docs/Welcome-Bengali.md)\n- [Chinese README](docs/Welcome-Chinese.md)\n- [Indonesian README](docs/Welcome-Indonesian.md)\n- [Japanese README](docs/Welcome-Japanese.md)\n- [Persian README](docs/Welcome-Persian.md)\n- [Polish README](docs/Welcome-Polish.md)\n- [Portuguese README](docs/Welcome-Portuguese.md)\n- [Romanian README](docs/Welcome-Romanian.md)\n- [Russian README](docs/Welcome-Russian.md)\n- [Spanish README](docs/Welcome-Spanish.md)\n- [Thai README](docs/Welcome-Thai.md)\n- [Turkish README](docs/Welcome-Turkish.md)\n- [Ukrainian README](docs/Welcome-Ukrainian.md)\n- [Vietnamese README](docs/Welcome-Vietnamese.md)\n\n## Releases\n\nSee [Release procedure](CONTRIBUTING.md#release-procedure) for more information about the release model.\n\n## Active Networks\n\n- Testnet `paloma-testnet-16` (May 23, 2024)\n- Mainnet `tumbler` (April 22, 2024)\n\n## Join an active Network\n\n\u003e #### Note\n\u003e\n\u003e Some have seen errors with GLIBC version differences with the downloaded binaries. This is caused by a difference in the libraries of the host that built the binary and the host running the binary.\n\u003e\n\u003e If you experience these errors, please pull down the code and build it, rather than downloading the prebuilt binary\n\n### Install the correct version of libwasm\n\nThe current required version of libwasm is `2.1.3`. If you're upgrading from a prior version it is recommended to remove the cache to avoid errors. If you're already have `palomad` running, you will need to stop it before doing these steps.\n\n```\nwget https://github.com/CosmWasm/wasmvm/releases/download/v2.1.3/libwasmvm.x86_64.so\nsudo mv libwasmvm.x86_64.so /usr/lib/\n\nrm -r ~/.paloma/data/wasm/cache\n```\n\n### To get the latest prebuilt `palomad` binary\n\n```shell\nwget -O - https://github.com/palomachain/paloma/releases/download/v2.4.11/paloma_Linux_x86_64.tar.gz  | \\\n  sudo tar -C /usr/local/bin -xvzf - palomad\nsudo chmod +x /usr/local/bin/palomad\n```\n\n### To build palomad using latest release\n\n\u003e [!IMPORTANT]  \n\u003e Always make sure you're building against the latest released version of Go.\n\n```shell\ngit clone https://github.com/palomachain/paloma.git\ncd paloma\ngit checkout v2.4.11\nmake build\nsudo mv ./build/palomad /usr/local/bin/palomad\n```\n\nIf you're upgrading to the most recent version, you will need to stop `palomad` before copying the new binary into place.\n\n### Connecting to an existing network\n\nDownload and install the latest release of palomad.\n\nInitialize our configuration. This will populate a `~/.paloma/` directory.\n\n```shell\nMONIKER=\"$(hostname)\"\npalomad init \"$MONIKER\"\n\n#for testnet\nCHAIN_ID=\"paloma-testnet-16\" \n#for mainnet\nCHAIN_ID=\"tumbler\" \n\n```\n\nCopy the configs of the network we wish to connect to\n\nTestnet:\n\n```shell\nwget -O ~/.paloma/config/genesis.json https://raw.githubusercontent.com/palomachain/testnet/master/paloma-testnet-16/genesis.json\nwget -O ~/.paloma/config/addrbook.json https://raw.githubusercontent.com/palomachain/testnet/master/paloma-testnet-16/addrbook.json\n```\n\nMainnet:\n\n```shell\nwget -O ~/.paloma/config/genesis.json https://raw.githubusercontent.com/palomachain/mainnet/master/tumbler/genesis.json\nwget -O ~/.paloma/config/addrbook.json https://raw.githubusercontent.com/palomachain/mainnet/master/tumbler/addrbook.json\n```\n\nNext you can generate a new set of keys to the new machine, or reuse an existing key.\n\n```shell\nVALIDATOR=\u003cchoose a name\u003e\npalomad keys add \"$VALIDATOR\"\n\n# Or if you have a mnemonic already, we can recover the keys with:\npalomad keys add \"$VALIDATOR\" --recover\n```\n\nHead over to \u003chttps://faucet.palomaswap.com/\u003e and get some funds!\n\nWe can verify the new funds have been deposited.\n\n```shell\npalomad query bank balances --node \"https://testnet.palomaswap.com:443\" \"$ADDRESS\"\n```\n\nAnd start the node!\n\n```shell\npalomad start\n```\n\nIf desired we can stake our funds and create a validator.\n\n```shell\nMONIKER=\"$(hostname)\"\nVALIDATOR=\"$(palomad keys list --list-names | head -n1)\"\nSTAKE_AMOUNT=1000000ugrain\nPUBKEY=\"$(palomad tendermint show-validator)\"\npalomad tx staking create-validator \\\n      --fees=1000000ugrain \\\n      --from=\"$VALIDATOR\" \\\n      --amount=\"$STAKE_AMOUNT\" \\\n      --pubkey=\"$PUBKEY\" \\\n      --moniker=\"$MONIKER\" \\\n      --website=\"https://www.example.com\" \\\n      --details=\"\u003center a description\u003e\" \\\n      --chain-id=$CHAIN_ID \\\n      --commission-rate=\"0.1\" \\\n      --commission-max-rate=\"0.2\" \\\n      --commission-max-change-rate=\"0.05\" \\\n      --min-self-delegation=\"100\" \\\n      --yes \\\n      --broadcast-mode=block\n```\n\nYou may receive an error `account sequence mismatch`, you will need to wait until your local paloma\ncatches up with the rest of the chain.\n\n#### Running with `systemd`\n\nFirst configure the service:\n\n```shell\ncat \u003c\u003c EOT \u003e /etc/systemd/system/palomad.service\n[Unit]\nDescription=Paloma Blockchain\nAfter=network.target\nConditionPathExists=/usr/local/bin/palomad\n\n[Service]\nType=simple\nLimitNOFILE=65535\nRestart=always\nRestartSec=5\nWorkingDirectory=~\nExecStartPre=\nExecStart=/usr/local/bin/palomad start\nEnvironment=PIGEON_HEALTHCHECK_PORT=5757\nExecReload=\n\n[Install]\nWantedBy=multi-user.target\nEOT\n```\n\nThen reload systemd configurations and start the service!\n\n```shell\nservice palomad start\n\n# Check that it's running successfully:\nservice palomad status\n# Or watch the logs:\njournalctl -u palomad.service -f\n```\n\n### Uploading a local contract\n\n```shell\nCONTRACT=\u003ccontract.wasm\u003e\nVALIDATOR=\"$(palomad keys list --list-names | head -n1)\"\npalomad tx wasm store \"$CONTRACT\" --from \"$VALIDATOR\" --broadcast-mode block -y --gas auto --fees 3000000000ugrain\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalomachain%2Fpaloma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpalomachain%2Fpaloma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalomachain%2Fpaloma/lists"}