> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Confidencial Fiat On-Ramp e Off-Ramp
> On-ramp e off-ramp fiat diretamente para e de um saldo privado, sem revelar o ativo ou a quantidade.
Os usuários podem realizar onramp e offramp de saldos fiat diretamente para e de seu saldo confidencial Solana. Nenhuma ação deposita em um saldo público, então nenhum revela o ativo ou a quantidade que um usuário usa no on-ramp ou off-ramp.
| Field | Visibility | Why |
| ------------------------ | ----------- | --------------------------------------------------------------------- |
| Fiat balance and payment | Not onchain | The fiat payment is not onchain |
| Asset | Private | The asset is encrypted onchain |
| Amount | Private | The transferred amount is encrypted onchain |
| Onramp Provider | Public | In a confidential Ring the wallet address of the provider is visible. |
| User wallet address | Public | In a confidential Ring the user wallet address is visible onchain. |
| Field | Visibility | Why |
| ------------------- | ----------- | --------------------------------------------------------------------- |
| Fiat payout | Not onchain | The fiat payout is not onchain |
| Asset | Private | The asset is encrypted onchain |
| Amount | Private | The transferred amount is encrypted onchain |
| Offramp Provider | Public | In a confidential Ring the wallet address of the provider is visible. |
| User wallet address | Public | In a confidential Ring the user wallet address is visible onchain. |
## Pré-requisitos:
* O provedor (por exemplo, uma exchange centralizada ou processador fiat-para-cripto) mantém um saldo privado do ativo para on-ramps e off-ramps privados (SOL ou qualquer token SPL / Token 2022, como USDC).
* Certifique-se de que a conta de on-ramp e off-ramp privada tenha saldo suficiente para atender seus usuários.
* O usuário possui uma Carteira Privada.
## Fluxos de Alto Nível
A etapa fiat depende do seu livro de registros interno. On-ramps e off-ramps privados podem ser integrados ao Default Ring ou a um Custom Ring. Um Custom Ring pode ser confidencial ou anônimo.
### 1. On-Ramp
Um on-ramp credita um saldo privado: o usuário paga fiat offchain; o provedor envia uma transferência privada onchain de sua conta on-ramp para a Carteira Privada do usuário.
1. O usuário deposita fiat.
2. O provedor combina o depósito fiat do usuário com uma Carteira Privada no livro de registros interno.
3. O provedor sincroniza o saldo privado da conta on-ramp para obter seu último saldo, então envia uma transferência privada para a Carteira Privada do usuário.
```mermaid theme={"system"}
%%{init: {
'theme': 'base',
'themeVariables': {
'lineColor': '#FF6B35',
'primaryTextColor': '#737373',
'primaryBorderColor': '#9CA3AF',
'actorBkg': '#FFFFFF',
'actorBorder': '#9CA3AF',
'actorTextColor': '#737373',
'signalColor': '#FF6B35',
'signalTextColor': '#737373',
'labelBoxBkgColor': '#FF6B351F',
'labelBoxBorderColor': '#FF6B35',
'noteBkgColor': '#F5F5F5',
'noteTextColor': '#737373',
'noteBorderColor': '#9CA3AF'
}
}}%%
sequenceDiagram
participant User
participant UW as UserWallet
participant P as Provider OnOfframp
participant RPC as RPC
participant SPP as Solana
User->>P: onramp request (fiat amount)
P->>RPC: sync the on-ramp account balance
RPC-->>P: latest on-ramp account balance
Note over P: build and sign the private transfer
P->>RPC: request proof
RPC-->>P: proof
P->>SPP: submit private transfer (on-ramp account to user)
SPP-->>P: confirmed, transaction hash
UW->>RPC: sync private balance
RPC-->>UW: confirm private balance
```
### 2. Off-Ramp
Um off-ramp é uma transferência privada da Carteira Privada do usuário para a conta off-ramp e uma atualização do livro de registros interno do provedor para pagar fiat ao usuário.
Os passos para completar um off-ramp privado incluem:
1. O usuário sincroniza seu saldo privado e envia uma transferência privada para a conta off-ramp do provedor.
2. Em um Ring confidencial, o provedor pode combinar a transferência pelo endereço da carteira do usuário visível. Em um Ring anônimo, o livro de registros público não revela remetente ou destinatário; combinar via solicitação de off-ramp no livro de registros interno.
```mermaid theme={"system"}
%%{init: {
'theme': 'base',
'themeVariables': {
'lineColor': '#FF6B35',
'primaryTextColor': '#737373',
'primaryBorderColor': '#9CA3AF',
'actorBkg': '#FFFFFF',
'actorBorder': '#9CA3AF',
'actorTextColor': '#737373',
'signalColor': '#FF6B35',
'signalTextColor': '#737373',
'labelBoxBkgColor': '#FF6B351F',
'labelBoxBorderColor': '#FF6B35',
'noteBkgColor': '#F5F5F5',
'noteTextColor': '#737373',
'noteBorderColor': '#9CA3AF'
}
}}%%
sequenceDiagram
participant User
participant UW as UserWallet
participant P as Provider OnOfframp
participant RPC as RPC
participant SPP as Solana
User->>P: send off-ramp request (amount)
UW->>RPC: sync private balance
Note over UW: build and sign the private transfer
UW->>RPC: request proof
RPC-->>UW: proof
UW->>SPP: submit private transfer (user to off-ramp account)
SPP-->>UW: confirmed, transaction hash
P->>RPC: sync off-ramp account
RPC-->>P: off-ramp request confirmed
Note over P: match sender to a user, credit fiat ledger
P->>User: pay out fiat
```
### 3. Conta de On-Ramp e Off-Ramp
A conta de on-ramp e off-ramp é um saldo privado do provedor para atender on-ramps e off-ramps de usuários. Pode manter SOL ou qualquer token SPL ou Token-2022 que você queira suportar, como USDC.
Certifique-se de que a conta de on-ramp e off-ramp tenha saldo suficiente para atender seus usuários, semelhante a on-ramps e off-ramps públicos.
#### Financiando a Conta de On-Ramp e Off-Ramp
Para financiar o saldo privado da conta, deposite de um saldo público Solana (Carteira pública de origem) para um saldo privado. Os usuários apenas interagem com a conta através de transferências privadas, então os montantes e ativos transferidos para o usuário nunca são expostos.
| Field | Visibility | Why |
| -------------------------- | ---------- | -------------------------------------------------- |
| Source public wallet | Public | The source wallet address is visible onchain |
| Asset | Public | The asset is visible onchain |
| Amount | Public | The deposited amount is visible onchain |
| Destination wallet address | Public | The destination wallet address is visible onchain |
| Resulting private balance | Private | The resulting private balance is encrypted onchain |
## Comcece a Integrar
Adicione suporte à privacidade com sua própria gestão de chaves. Para provedores que desejam gerenciar chaves de criptografia e realizar sincronização de estado.
Adicione suporte à privacidade ao seu aplicativo via REST API. Para provedores e aplicativos que desejam começar rapidamente sem sua própria gestão de chaves e sincronização de estado.
Adicione suporte à privacidade via REST API e configure um custom ring com controles de política e conformidade.
Para fintechs, plataformas de folha de pagamento, empresas de remessas, neobancos e empresas.
## Didn't find what you were looking for?
Reach out! [Telegram](https://t.me/tilo_light) | [E-Mail](mailto:sales@helius.xyz) | [Contact](https://www.helius.dev/contact)