Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/weichain/galactic-bridge-icp
https://github.com/weichain/galactic-bridge-icp
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/weichain/galactic-bridge-icp
- Owner: weichain
- License: apache-2.0
- Created: 2024-02-15T14:57:12.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-06-28T11:13:54.000Z (4 months ago)
- Last Synced: 2024-08-02T06:19:11.545Z (3 months ago)
- Language: Rust
- Size: 276 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-internet-computer - Galactic Bridge - Canister-controlled SOL bridge using Chain Fusion tech. (Chain Fusion / Solana)
README
# galactic_bridge_icp
## Deployment
Deploys ledger and minter
```bash
dfx start --background
./scripts/export.sh
./scripts/deploy.sh --all
```
## (Re)Generating candid file (minter.did)
```bash
./scripts/did.sh
```
# Flow examples
## Sol to gSol
```
┌────┐ ┌───────────────┐ ┌──────────┐┌──────────┐
│User│ │Solana Contract│ │ Minter ││ Ledger │
└─┬──┘ └───────┬───────┘ └────┬─────┘└─────┬────┘
│ │ │ │
│ deposit │ │ │
│───────────>│ │ │
│ │ scraps transactions │ │
│ │<───────────────────────│ │
│ │ │ on deposit │
│ │ │ mint asset │
│ │ │───────────>│
│ │ │ │
┌─┴──┐ ┌───────┴───────┐ ┌────┴─────┐┌─────┴────┐
│User│ │Solana Contract│ │ Minter ││ Ledger │
└────┘ └───────────────┘ └──────────┘└──────────┘
```
## gSol to Sol
```
┌───────────────┐ ┌────┐ ┌──────────┐┌──────────┐
│Solana Contract│ │User│ │ Minter ││ Ledger │
└─┬─────────────┘ └─┬──┘ └────┬─────┘└─────┬────┘
│ │ │ │
│ │ give "icrc2_approve" to minter │
│ │─────────────────────────────────>│
│ │ │ │
│ │ burn │ │
│ │────────────────────>│transfer_from
│ │ │───────────>│
│ │ generate coupon │ │
│ │<────────────────────│ │
│ withdraw │ │ │
│<────────────────│ │ │
│ │ │ │
┌─┴─────────────┐ ┌─┴──┐ ┌────┴─────┐┌─────┴────┐
│Solana Contract│ │User│ │ Minter ││ Ledger │
└───────────────┘ └────┘ └──────────┘└──────────┘
```
Coupon holds message(address to receive asset, amount, etc.), signature and public address and is used to release SOL from solana contract
# Help
## get_ledger_id
```bash
dfx canister call minter get_ledger_id
```
## get_address
Returns Threshold ECDSA address ("ecdsa_public_key") in 3 formats:
1) compressed public key (size: 33 bytes, generated from icp)
2) uncompressed public key (size: 64 bytes, generated from compressed version via "libsecp256k1" library)
```bash
dfx canister call minter get_address
```
## withdraw
Withdraw burns gsol and provides a coupon
```bash
dfx canister call ledger icrc1_balance_of "(record {
owner = principal \"$USER_PRINCIPAL\"
})"
dfx canister call ledger icrc1_total_supply
dfx canister call ledger icrc2_approve "(record {
spender = record { owner = principal \"$(dfx canister id minter)\" };
amount = 100_000_000;
})" --identity $USER_PRINCIPAL_NAME
# provide solana address and amount
dfx canister call minter withdraw "(\"HS6NTv6GBVSLct8dsimRWRvjczJTAgfgDJt8VpR8wtGm\", 100_000)" --identity $USER_PRINCIPAL_NAME
```
Coupon Example:
```rust
{
/// The recovery ID (y parity) for signature
recovery_id = opt (0 : nat8);
/// The hexadecimal representation of the ICP public key in non compressed format.
icp_public_key_hex = "04de48381e1b54e2463cafdcafc3aaf7d99b1c512a16ac60e6415514d07ab78d6010b31fc919cc196b82ede54859f1d9cd69258f83b5d5bb146a77f326b9a723ab";
/// The message associated with the coupon.
/// This message typically contains details about the withdrawal event.
message = "{"from_icp_address":"svq52-4c5cd-olo3w-r6b37-jizpw-kixdx-uarhl-nolu3-gcikk-nza7z-yae","to_sol_address":"8nZLXraZUARNmU3P8PKbJMS7NYs7aEyw6d1aQx1km3t2","amount":100000,"burn_id":2,"burn_timestamp":1711616761296437000,"icp_burn_block_index":106}";
/// The signature of the coupon.
signature_hex = "ac30c685a756feafbe9e34939054fb8e7b0879039f18eb536a06a12483f0f8d25f4e6fc29cf5fbb9742d0e9fff39dbf3bbc3adf3b56477adb614417c4157168a";
/// The hash of the message associated with the coupon.
message_hash = "8278c60c27f95ccb2b0956c4b7ed9ef90e1ec67d3d8cf88cec39632d3f0d4bf0";
}
```
No matter who executes the withdrawal process on the Solana side, the asset will be reimbursed to the Solana address provided during the minter canister call.
## get_withdraw_info
```bash
dfx canister call minter get_withdraw_info --identity $USER_PRINCIPAL_NAME
```
## get_state
```bash
dfx canister call minter get_state --identity="$OWNER_PRINCIPAL_NAME"
```
## get_storage
```bash
dfx canister call minter get_storage --identity="$OWNER_PRINCIPAL_NAME"
```
## get_active_tasks
```bash
dfx canister call minter get_active_tasks --identity="$OWNER_PRINCIPAL_NAME"
```
# Known Issues
1) Solana Testnet and Devnet do not retain transactions and transaction signatures for an extended period. This can lead to
issues in the Solana parser, such as encountering existing signatures without corresponding transaction data. Currently,
any parsing issue encountered is retried up to 100 times before being dropped. It may be beneficial to implement a mechanism
with progressively longer retry periods for improved handling of such issues.".
2) Solana RPC provider free version has a request limit. At this point batching for transaction calls is not possible on mainnet!
Each call is duplicated 13 times for each node on the subnet.
## MAINNET PUBLIC KEY - test_key_1
"02449d7bbca9446df12f0f929c088edfec7223c339f5d98cb5b4055572a36c94f0"
"04449d7bbca9446df12f0f929c088edfec7223c339f5d98cb5b4055572a36c94f0888809b30f7a499fcc0c2292c682fb3d7adc7656ef0d6d3f689a15ebee9c23cc"
## MAINNET PUBLIC KEY - key_1
"03c1ab9735077d400d7e992087ed3e09721ecd25d2238f5b6d0ec5f899aff090db"
"04c1ab9735077d400d7e992087ed3e09721ecd25d2238f5b6d0ec5f899aff090db0f3c5b976ca2305440f31367e3b5c51cb58413de5962714ea41015812ed5069f"
## LATEST SOLANA INITIAL SIGNATURE
dhCUjkhdmEw18r1uNVxKanMyEXYmdcp56UBUmLXkgnPU8QFoHJYKy4UMrHLHk7oxUWXc13gvcL11ivCNJADaMJN
## SOLANA CONTRACT ADDRESS
AAJL4DeXnWBNRowWjvpkAgwtAACpz6NfaA1T2p8Hrpy