Label 309 게이트웨이란 무엇입니까?

Label 309 게이트웨이는 존재 증명 레코드를 Cardano에 게시하는 서비스입니다. 가격 책정, 업로드, 트랜잭션 제출, 확인 추적, 레코드 색인, 잔액, API 키, 웹훅 같은 운영 작업을 게이트웨이가 처리하므로 클라이언트는 그 부담을 지지 않습니다. 클라이언트는 증명을 준비하고 개인 키를 로컬에 보관하며, 게이트웨이는 레코드를 네트워크에 올립니다.

Label 309는 콘텐츠 해시를 메타데이터 레이블 309 아래에서 Cardano에 고정하기 위한 개방형 벤더 중립 표준입니다. 게이트웨이는 그중 게시를 담당하는 부분입니다. 게이트웨이는 한 회사만 쓸 수 있는 비공개 백엔드가 아니라, 어떤 제품이든 직접 운영하거나 연동할 수 있는 정의된 서비스 계층이며, 참조 구현은 오픈 소스입니다. CardanoWall은 바로 이 동일한 인터페이스 위에서 자사 상용 제품을 운영하며, 자기 자신을 위한 별도 경로를 두지 않습니다.

게시에 왜 게이트웨이가 필요합니까?

검증은 가볍습니다. 게시는 운영의 영역입니다.

증명을 검증할 때는 보통 Cardano 트랜잭션 참조에서 출발해 공개 탐색기에서 레코드를 가져온 다음, 해시나 서명을 직접 다시 계산합니다. 별도의 서비스는 필요하지 않습니다. 이 독립성이야말로 표준의 핵심입니다. (전체 절차는 Label 309 레코드를 검증하는 방법을 참고하십시오.)

게시에는 맞물려 돌아가는 요소가 훨씬 많습니다.

유효한 Label 309 레코드를 구성합니다;
Cardano 트랜잭션 비용을 추정합니다;
파일이 관련되면 암호문이나 콘텐츠를 업로드합니다;
스토리지 비용을 지불합니다;
Cardano 트랜잭션을 제출합니다;
확인을 기다립니다;
실패와 환불을 처리합니다;
결과를 색인합니다;
사용자에게 상태를 노출합니다;
계정 잔액을 정확하게 유지합니다.

게이트웨이는 이러한 관심사를 API 뒤에 묶어 둡니다. 게이트웨이가 없다면 게시를 원하는 모든 제품이 동일한 체인·스토리지 파이프라인을 매번 다시 만들어야 합니다. 게이트웨이가 있으면 제품 팀은 사용자 경험과 비즈니스 워크플로에 집중하고, 체인·스토리지·회계는 게이트웨이가 맡습니다.

게이트웨이는 실제로 무엇을 합니까?

게이트웨이는 게시 파이프라인과 그 뒤의 자금·체인·스토리지 상태를 소유합니다. 구체적으로 다음을 수행할 수 있습니다.

게시 전에 증명에 대한 견적을 냅니다(가격은 약 15분의 짧은 시간 동안 유지됩니다);
암호화된 업로드와 공개 콘텐츠 업로드를 받아 콘텐츠 주소 지정 URI를 반환합니다;
준비된 증명 레코드를 받습니다;
정확한 수수료로 Cardano 트랜잭션을 구성하고 제출합니다;
리오그 처리를 포함해 확인을 추적합니다;
게시가 영구적으로 실패하면 청구를 자동으로 환불합니다;
네트워크상의 모든 Label 309 레코드를 공유 공개 피드로 색인합니다;
선불 계정 잔액을 관리하고 가격을 적용합니다;
API 키와 계정 토큰을 발급합니다;
수명 주기 이벤트에 대한 웹훅을 보냅니다.

이로써 게이트웨이는 CardanoWall 웹 앱, 데스크톱 앱, 명령줄 도구, SDK 기반 연동, CI/CD 워크플로, 그리고 서드파티 제품에 이르기까지 모든 곳의 게시 엔진이 됩니다.

게이트웨이가 의도적으로 하지 않는 일은 무엇입니까?

게이트웨이는 신뢰의 뿌리가 아닙니다.

게이트웨이는 신원 시드(Identity Seed)를 결코 필요로 하지 않습니다. 수신자의 개인 키도 필요로 하지 않습니다. 봉인된 파일을 복호화하지 않습니다. 그리고 증명을 확인할 수 있는 유일한 장소가 되는 일도 결코 없습니다. 이러한 특성은 설계에 따른 것이며, 이를 게이트웨이 밖에 두는 것이 곧 증명이 홀로 설 수 있게 하는 비결입니다.

유효한 Label 309 증명은 게이트웨이의 말이 아니라 공개 데이터에 기반합니다.

Cardano 트랜잭션;
Label 309 메타데이터;
필요할 때는 원본 콘텐츠나 암호문;
레코드 서명과 공개 키;
배치 레코드의 경우 Merkle 증명;
봉인된 콘텐츠의 경우 수신자 자신의 키.

게이트웨이가 증명이 존재한다고 보고하더라도, 검증하는 측은 게이트웨이의 개입 없이 체인에 대조해 직접 확인할 수 있습니다. 게이트웨이 운영자가 관찰할 수 있는 것과 없는 것에 대해서는 CardanoWall이 볼 수 있는 것을 참고하십시오.

데이터 플레인이란 무엇입니까?

데이터 플레인은 사용자 대면 API입니다. 클라이언트가 사용자나 계정을 대신해 동작할 때 호출하는 대상이며, 견적·업로드·게시·잔액 조회·레코드 목록 조회를 요청하는 웹 앱, 데스크톱 앱, CLI, SDK, 자동화 스크립트가 여기에 해당합니다. 이는 /api/v1/* 경로에 있습니다.

개념적 흐름은 짧습니다.

견적을 요청합니다.
파일이 관련되면 콘텐츠나 암호문을 업로드합니다.
증명을 게시합니다.
상태를 추적합니다.
레코드와 잔액을 읽습니다.

이는 참조 제품이 사용하는 것과 동일한 경로입니다. 어떤 흐름이 CardanoWall에서 동작한다면, 그것은 공개 데이터 플레인을 통해 누구에게나 제공됩니다.

컨트롤 플레인이란 무엇입니까?

컨트롤 플레인은 운영자와 제품 백엔드를 위한 것이며, /control/v1/* 경로에 있습니다.

어떤 회사가 게이트웨이 위에 자체 제품을 구축한다면, 그 백엔드는 계정을 생성하고, 청구 크레딧을 적용하고, 수명이 짧은 계정 토큰을 발급하고, 계정별 마진을 설정하고, API 키를 생성하고, 운영자 수준의 작업을 실행해야 합니다. 이것은 컨트롤 플레인의 작업이며, 신뢰할 수 있는 백엔드에서만 일어나야 합니다. 브라우저 코드나 모바일 클라이언트에서는 결코 안 됩니다.

컨트롤 플레인은 하나의 게이트웨이가 둘 이상의 제품을 지원할 수 있게 하는 요소입니다. 다른 팀은 그 위에 자체 벤더 계층을 운영할 수 있습니다. 자체 사용자, 청구, UI, 지원, 제품 의미 체계를 두고, 그 아래의 기본 게시 파이프라인은 게이트웨이가 맡습니다. 둘 사이의 경계는 HTTP API와 웹훅 파이어호스이며, 엔진 내부에 비공개로 유지되는 게이트웨이의 데이터베이스가 아닙니다.

"비공개 문이 없다"는 무슨 뜻입니까?

이는 참조 제품이 다른 모든 사람과 동일한 인터페이스를 통해 게시한다는 뜻입니다. CardanoWall만을 위한 비밀스럽거나 더 빠르거나 특권적인 경로는 없습니다.

이는 신뢰도에 중요합니다. 어떤 프로젝트가 표준이 개방적이라고 주장하면서 정작 숨겨진 내부 장치를 통해 게시한다면, 생태계는 그 한 벤더에 계속 종속될 것입니다. 게이트웨이 모델은 그 종속성을 제거합니다. CardanoWall은 잘 다듬어진 첫 제품이 될 수 있고, 다른 팀들은 동일한 표준 경로 위에서 자체 도구, 서비스, 대시보드, 데스크톱 클라이언트, 산업 워크플로를 구축할 수 있습니다. 그 위에서 무언가를 만들고 있다면 Label 309 게이트웨이 위에서 구축하기를 참고하십시오.

회사가 자체 게이트웨이를 운영할 수 있습니까?

가능합니다. 게이트웨이 코어는 단일 Rust 바이너리와 PostgreSQL로 구성된 오픈 소스이며, 회사가 직접 운영할 수 있습니다. 자체 Cardano 및 Arweave 지갑에 자금을 채우고, 자체 계정과 API 키를 생성하며, 호스팅 운영자로서의 CardanoWall에 의존하지 않고 Label 309 레코드를 게시할 수 있습니다.

자체 호스팅은 다음과 같은 경우에 적합할 수 있습니다.

대용량 게시;
엄격한 벤더 정책;
규제 대상이거나 에어갭 환경;
내부 컴플라이언스 워크플로;
법적 증거 시스템;
AI 출처 증명 인프라;
CI/CD 증명 파이프라인;
이미 자체 클라우드와 체인 인프라를 운영하는 팀.

자체 호스팅은 레코드 표준을 바꾸지 않습니다. 자체 호스팅 게이트웨이도 동일한 레코드를 만들어 내며, 이는 누구나 검증할 수 있습니다. 바뀌는 것은 게시 서비스를 누가 운영하느냐일 뿐입니다. 실제 설정 방법은 자체 게이트웨이 운영하기에서 다룹니다.

호스팅된 CardanoWall 게이트웨이는 언제 사용해야 합니까?

직접 인프라를 운영하는 것보다 편의성이 더 중요할 때 호스팅된 게이트웨이를 사용하십시오.

호스팅 서비스는 자금 조달, 가격 책정, 제출, 확인, 스토리지, 계정 관리를 사용자를 대신해 처리합니다. 이는 개인 사용자, 소규모 팀, 초기 연동, 그리고 빠르게 시작하고 싶은 회사에 적합합니다. 여전히 표준 레코드를 얻고, 여전히 공개 데이터로 검증할 수 있으며, 나중에 자체 도구나 자체 게이트웨이로 옮겨갈 수도 있습니다. 호스팅이 곧 종속을 뜻하지는 않습니다.

대신 자체 호스팅은 언제 해야 합니까?

편의성보다 운영 통제가 더 중요할 때 자체 호스팅을 하십시오. 합당한 이유로는 다음이 있습니다.

대용량으로 게시합니다;
자체 수수료 및 자금 정책을 원합니다;
조직이 서드파티 호스팅 서비스에 의존할 수 없습니다;
레코드가 내부의 규제 대상 워크플로에 속합니다;
제품에 자체 청구 모델이 필요합니다;
자체 브랜드로 Label 309 게시를 제공하고자 합니다;
API 키, 계정, 웹훅을 직접 통제하고자 합니다.

자체 호스팅은 손이 더 많이 갑니다. 게이트웨이를 운영하고, 지갑에 자금을 채우고, 공급자를 모니터링하고, 시크릿을 관리하고, 데이터베이스를 운영하고, 업그레이드를 처리하며, 서비스를 건강하게 유지해야 합니다. 그 대가는 독립성입니다.

가격 책정은 어떻게 들어맞습니까?

게시에 돈이 드는 이유는 게이트웨이가 실제 비용을 지불하기 때문입니다. 모든 증명은 Cardano 트랜잭션을 고정하며, 이 트랜잭션에는 네트워크 수수료가 따릅니다. 파일이 관련되면 게이트웨이는 Arweave 스토리지 비용도 지불합니다. 그 위에 환율 처리, 자금 조달, 인프라, 모니터링, 지원, 환불, 위험까지 짊어집니다.

그래서 호스팅된 게이트웨이는 비용 전가 방식에 서비스 마진을 더해 청구합니다. 환율은 실시간입니다. 게이트웨이는 하드코딩된 상수가 아니라 현재 시장 환율로 각 견적의 가격을 산정하며, 견적 뒤의 환율은 변할 수 있습니다. 바로 그래서 견적은 짧은 시간 동안만 유효합니다. 표시 가격은 계정, 파트너, 운영자 정책에 따라 달라질 수 있습니다. 애초에 청구하는 이유의 배경에 대해서는 게시에 가격이 있는 이유를 참고하십시오.

호스팅 중개자의 마진을 피하고 싶다면, 그 답은 무료 게시가 아닙니다. 체인과 스토리지 비용은 어느 쪽이든 실제로 발생합니다. 답은 게이트웨이를 직접 운영하고, 직접 자금을 채우며, 운영 작업을 스스로 떠맡는 것입니다.

데스크톱 앱은 게이트웨이와 어떤 관계입니까?

CardanoWall Desktop은 Rust SDK 위에 구축된 오픈 소스 데스크톱 앱으로, 체인 운영자가 아니라 게이트웨이 클라이언트입니다.

이 앱은 신원을 로컬에 보관하고, 봉인된 레코드를 사용자 자신의 컴퓨터에서 동기화하고 시험 복호화하며, 오프라인 사용을 위해 데이터를 캐시하고, 레코드를 준비하고 서명하며, 파일을 암호화하고, 증명을 검증합니다. 이 모두를 로컬에서 합니다. 이 앱은 명시적으로 지갑이 아닙니다. ADA를 보관하지 않으며 Cardano 트랜잭션을 직접 구성하거나 제출하지 않습니다. 체인이나 스토리지에 닿는 작업이라면 게이트웨이를 가리키고, 게시 파이프라인은 게이트웨이가 소유하게 합니다.

어떤 게이트웨이를 쓸지는 사용자가 선택합니다.

호스팅된 CardanoWall 게이트웨이;
회사의 자체 게이트웨이;
임의의 서드파티 게이트웨이;
로컬 또는 개발용 게이트웨이.

데스크톱은 로컬 경험을 소유하고, 게이트웨이는 게시를 소유합니다. 이 앱에 대한 자세한 내용은 CardanoWall Desktop에서 다룹니다.

개발자가 유념해야 할 점은 무엇입니까?

게이트웨이 내부가 아니라 표준 경계, 즉 HTTP 플레인과 웹훅을 대상으로 구축하십시오.

몇 가지 규칙이 연동을 건전하게 유지합니다.

게이트웨이의 데이터베이스를 직접 조회하지 마십시오. 이는 엔진 내부에 속하며 예고 없이 바뀔 수 있습니다.
운영자 자격 증명을 클라이언트에 두지 마십시오. 운영자 권한이 필요한 것은 모두 백엔드에 두어야 합니다.
캐시된 잔액을 지출 결정의 진실 공급원으로 취급하지 마십시오. 잔액이 청구를 좌우하는 경우에는 게이트웨이의 잔액을 읽으십시오.
게시 실패에 대해 자체 환불 경로를 만들지 마십시오. 게이트웨이가 이미 자동으로 환불하므로, 두 번째 환불은 이중 지급이 됩니다.
게이트웨이에 사용자 콘텐츠를 복호화해 달라고 요청하지 마십시오.

깔끔한 형태는 단순합니다. 클라이언트나 백엔드가 사용자 의도를 포착하고, 클라이언트는 시크릿을 로컬에 두며, 게이트웨이는 견적·업로드·게시·확인·색인을 처리하고, 제품은 그 위에 자체 UI와 읽기 모델을 구축하며, 검증은 독립적으로 유지됩니다. 이것이 바로 모든 제품을 체인·스토리지 운영자로 만들지 않고도 하나의 표준이 여러 제품을 지원할 수 있는 방식입니다.

짧게 정리하면

Label 309 게이트웨이는 게시 계층입니다. 레코드를 견적·업로드·게시·확인·색인하고 노출합니다. CardanoWall이 호스팅하거나, 회사가 자체 호스팅하거나, 다른 제품에 통합할 수 있습니다.

게이트웨이는 신뢰의 뿌리가 아니며, 사용자의 개인 키를 보관하지 않습니다. 게이트웨이는 누구나 공개 Cardano 데이터로부터 검증할 수 있는 표준 레코드를 게시합니다. 바로 이것이 표준을 개방적으로 유지하는 비결입니다.

더 읽어보기

Label 309 게이트웨이 위에서 구축하기 — 데이터 플레인과 컨트롤 플레인을 위한 연동 패턴.
자체 게이트웨이 운영하기 — 자체 호스팅 인스턴스 운영하기.
게시에 가격이 있는 이유 — 견적 뒤에 있는 비용 모델.
Label 309 레코드 검증하기 — 공개 데이터만으로 증명을 확인하기.
개방형 표준은 label309.org에서, 오픈 소스 코드는 github.com/cardanowall에서 확인할 수 있습니다. Label 309는 Cardano CIP 절차에 제출되어 메타데이터 범주 제안으로서 CIP 편집자들의 검토를 받고 있습니다(공개 PR).