ROOT03_BNPL_REPAYMENTSBNPL_MECHANICS

POLARIS_PROTOCOL //
MASTER_SPECIFICATION

The first cross-chain BNPL network on Creditcoin. Polaris utilizes a Hub-and-Spoke architecture to aggregate liquidity from multiple chains and provide instant credit lines.

[1.0]

HUB_AND_SPOKE_MODEL

Polaris separates state into two layers: The **Master Hub** (USC Hub V2) handles credit logic, scoring, and global balances. **Spoke Chains** (Sepolia, Hedera, Base) house the Liquidity Vaults where users deposit assets.

MASTER_HUB (CREDITCOIN_USC)

  • • PoolManager.sol (Global State)
  • • LoanEngine.sol (Credit Logic)
  • • ScoreManager.sol (Credit Score)

SPOKE_CHAINS (EVM_EXTENSIONS)

  • • LiquidityVault.sol (Assets)
  • • MockERC20.sol (Tokens)
  • • Prover_API (Cross-chain Verification)
[2.0]

LIQUIDITY_SYNCHRONIZATION

Liquidity is synced via **Native Verification Proofs**. When a user deposits on a Spoke, the Proof-Gen API generates a Merkle Proof which is then submitted to the Hub's `PoolManager`.

typescript — use-polaris.ts
1const receipt = await poolManager.addLiquidityFromProof(
2proof.chainKey,
3proof.blockHeight,
4proof.encodedTransaction,
5proof.merkleRoot,
6proof.siblings
7);
[3.0]

CREDIT_SCORE_SYSTEM

The **ScoreManager** tracks user behavior. Your credit limit is a dynamic function of your **Aggregated Collateral** and your **Polaris FICO Score** (300 to 850).

FORMULA_01: CREDIT_LIMIT

Limit = Total_Collateral * (Score / 1000)

LTV scales from 30% (Bad Score) to 85% (Perfect Score).

SCORE_BOOSTS

On-time Repayment = +5 Points

Partial repayments also contribute to score normalization.

[4.0]

CROSS_CHAIN_POOLS

Polaris supports multi-chain asset aggregation. Whitelisted tokens are mapped to global pools on the Hub, allowing a Sepolia-deposited USDC to back a credit line used for a payment on another chain.

ETH

SEPOLIA_USDC

0xbCFC...C44A

ACTIVE

CHAIN_ID: 11155111

HBAR

HEDERA_USDT

0x2A2...B5F

ACTIVE

CHAIN_ID: 296

[5.0]

INTEGRATION_API

Third-party merchants can integrate Polaris BNPL via the **MerchantRouter**. This allows instant settlements for users while the protocol handles the deferred payment logic.

// cURL Example: Initialize BNPL Checkout

curl -X POST https://api.polaris.finance/v1/checkout \

-H "Authorization: Bearer $API_KEY" \

-d '{ "amount": 150.00, "currency": "USD", "merchant_id": "M_8231" }'