Create PiOSbridge.js Pull Request Template for PiOS App List

[josefkedwards]

🌉 Interchaining and Bridging Pi

🚀 Connecting Pi Network with Cosmos, BNB Chain, and Beyond

---

🔥 Overview

Interchaining and Bridging Pi is an open-source project under the PiOS License, designed to bridge Pi Network to the Cosmos IBC ecosystem and BNB Chain. This integration enables:

✅ Seamless cross-chain transfers between Pi, BNB, Cronos, Ethereum, and Cosmos chains.
✅ Interoperability through IBC & Binance Bridge for moving assets.
✅ Smart contract support for decentralized applications (dApps).
✅ Increased liquidity for Pi tokens by connecting with external DeFi ecosystems.

This project is community-driven and not maintained by the Pi Core Team (Pi-CT).

---

🛠️ Features

🔹 IBC Integration – Enabling Pi transactions across Cosmos-based chains.
🔹 Binance Bridge Support – Wrapping Pi as a BEP20 token for BNB Chain.
🔹 Gravity Bridge / Peggy – Bridging Pi with Ethereum for ERC20 compatibility.
🔹 Relayer Automation – Handling cross-chain transfers seamlessly.
🔹 Decentralized dApp Support – Enabling Pi-powered applications on multi-chain.

---

🌍 Supported Blockchains

Blockchain	Integration Method	Status
Pi Network	Native Chain	✅ Active
BNB Chain	Binance Bridge (BEP20)	🔄 In Progress
Cronos	Gravity Bridge / IBC	🔄 In Progress
Ethereum	Gravity Bridge (ERC20)	🔄 In Progress
Cosmos Ecosystem	IBC Protocol	🔄 In Progress

---

🏗️ Architecture

🔗 Bridging Workflow

1️⃣ User deposits Pi tokens into a bridge smart contract on Pi Network.
2️⃣ The bridge locks Pi tokens and mints wrapped versions on BNB/Cosmos.
3️⃣ Users can transfer wrapped Pi across BNB, Cosmos, Cronos, and Ethereum.
4️⃣ Reverse transactions allow Pi withdrawals back to Pi Network.

🛠 Tech Stack

• Backend: Go (Cosmos SDK), Rust (IBC Relayer)
• Smart Contracts: Solidity (Ethereum), CosmWasm (Cosmos)
• APIs & Relayers: JavaScript (Web3.js, CosmJS)

---

🔥 Getting Started

📌 Clone the Repository

git clone https://github.com/pi-apps/interchaining-bridging-pi.git
cd interchaining-bridging-pi

[josefkedwards]

@bearycool11 @AdityaSripal @coderabbitai

[bearycool11]

Nice I like this proposal

[bearycool11]

@zolcsi @jiakuant1120

[bearycool11]

@coderabbitai I am approving this proposal

[Okeha]

Hi,
We would need you to create a PR on this repository adding your application's information to the PiOS App List table. Follow the formatted row template given on that doc, and fill in the below information as incomplete submissions will be rejected. For further instructions you can find that here: https://github.com/pi-apps/PiOS

[bearycool11]

we're missing the gravity bridge logic is all for this found in the IBC architecture documentation.

I would include

const { GravityBridgeClient } = require("gravity-bridge-sdk"); // Hypothetical Gravity Bridge SDK

/**

• Bridges a token from Ethereum to Cosmos using Gravity Bridge.

• @param {string} tokenContract - The Ethereum contract address of the token.

• @param {string} amount - The amount of tokens to bridge.

• @param {string} recipientAddress - The recipient address on the Cosmos chain.

• @returns {string} The transaction hash of the Gravity Bridge transfer.
  */
  async function bridgeTokenViaGravity(tokenContract, amount, recipientAddress) {
  try {
  console.log(🔄 Bridging ${tokenContract} -> Cosmos via Gravity | Amount: ${amount});

  // Initialize Gravity Bridge client
  const gravityClient = new GravityBridgeClient({
  ethereumRpc: process.env.ETHEREUM_RPC_URL, // Ethereum RPC URL
  cosmosRpc: process.env.COSMOS_RPC_URL, // Cosmos RPC URL
  privateKey: process.env.PRIVATE_KEY, // Your Ethereum private key for signing transactions
  });

  // Perform the bridging operation
  const txHash = await gravityClient.bridgeToCosmos({
  tokenContract: tokenContract,
  amount: amount,
  recipient: recipientAddress,
  });

  console.log(✅ Token bridged successfully via Gravity! Tx Hash: ${txHash});
  return txHash;
  } catch (error) {
  console.error("🚨 Error during Gravity Bridge transfer:", error.message);
  }
  }

/* ------------------------ MAIN SCRIPT ---------------------------- */

/**

• Main function to demonstrate the full flow.
  */
  async function main() {
  verifyEnv();

// 1. Pi Wallet Tethering
const piWallet = generatePiWallet();
console.log("Generated Pi Wallet:", piWallet);

// 2. Governance Proposal Submission
const proposalId = await submitGovernanceProposal();
if (!proposalId) return;

// 3. Bridge to BNB
const tokenSymbol = "BTC";
const amount = "0.01";
const recipientAddress = "bnb1....."; // Replace with actual BNB recipient address
const txId = await bridgeTokenToBNB(tokenSymbol, amount, recipientAddress);
if (!txId) return;

// 4. Relay to Cronos
const cronosAddress = "cronos1....."; // Replace with actual Cronos recipient address
await relayToCronos(tokenSymbol, amount, cronosAddress);

// 5. Gravity Bridge to Cosmos
const ethereumTokenContract = "0x....."; // Replace with actual Ethereum token contract address
const cosmosRecipientAddress = "cosmos1....."; // Replace with actual Cosmos recipient address
await bridgeTokenViaGravity(ethereumTokenContract, amount, cosmosRecipientAddress);

// Note: Actual Pi mining logic can be added here.
}

// Run the main script
main().catch(console.error);

documentation on layer zero and the gravity bridge can also be found

https://ibcprotocol.dev/blog/the-interop-series-ibc-and-layerzero#architecture

[bearycool11]

#276

[bearycool11]

I would make sure there are two separate .js files, one named gravity bridge.js and this one fyi.

[bearycool11]

Hi, We would need you to create a PR on this repository adding your application's information to the PiOS App List table. Follow the formatted row template given on that doc, and fill in the below information as incomplete submissions will be rejected. For further instructions you can find that here: https://github.com/pi-apps/PiOS

Sounds good I will get to that next