From 92ff522754a4b136ceaf58abd86ab2b43b4c3e95 Mon Sep 17 00:00:00 2001
From: Agustina Aldasoro <agustina.aldasoro@smartcontract.com>
Date: Fri, 7 Feb 2025 12:25:21 -0300
Subject: [PATCH] Add sequence diagrams

---
 chains/solana/contracts/flows.md | 47 ++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 chains/solana/contracts/flows.md

diff --git a/chains/solana/contracts/flows.md b/chains/solana/contracts/flows.md
new file mode 100644
index 000000000..211983f5b
--- /dev/null
+++ b/chains/solana/contracts/flows.md
@@ -0,0 +1,47 @@
+CCIP Send Flow
+```mermaid
+sequenceDiagram
+    participant U as CCIP Sender
+    participant R as Router + OnRamp
+    participant F as FeeQuoter
+    participant TP as Token Program
+    participant T as Token Pool
+
+    U->>R: CCIP Send
+    R->>F: CPI: Get Fee
+    R->>TP: CPI: Transfer Fee
+    R->>T: CPI: Transfer Tokens + Lock/Burn
+    Note right of T: Token Pool implementation<br/>supports up to 3 CPIs
+    R-->>R: Emit CCIPMessageSent
+```
+
+Commit Flow
+```mermaid
+sequenceDiagram
+    participant N as Offchain Node
+    participant R as Router + OnRamp
+    participant F as FeeQuoter
+    participant O as OffRamp
+
+    N->>O: Commit
+    O-->>R: PDA: Get config
+    O->>F: CPI: Store Prices
+    O-->>O: Store Merkle Root
+```
+
+
+Execute Flow
+```mermaid
+sequenceDiagram
+    participant N as Offchain Node
+    participant R as Router + OnRamp
+    participant O as OffRamp
+    participant T as Token Pool
+    participant C as CCIP Receiver
+
+    N->>O: Execute
+    O-->>R: PDA: Get config
+    O->>T: CPI: Transfer Tokens +<br/>Release/Mint
+    O->>C: CPI: CCIP Receive
+```
+