Change Log
Last updated
Last updated
안정성과 보안 강화를 위해 Node.js 22 버전으로 업그레이드 되었습니다.
(버그 수정) 법인 검증 시 일부 발생하던 해싱 오류가 수정되었습니다.
데이터베이스 SSL connection을 지원하도록 수정되었습니다.
에 SSL 연결을 위한 환경 변수가 추가되었습니다.
드물게 발생하는 INVALID-FORMAT 오류가 나지 않도록 수정했습니다.
(버그 수정) 지리적 주소가 포함된 개인 정보를 저장할 때 buildingNumber와 buildingName을 서로 바꿔서 저장하는 버그를 수정하였습니다.
보안을 강화하기 위해 Enclave 서버가 non-root 유저로 동작하도록 수정되었습니다.
PostgreSQL 사용시 public schema를 사용하지 않고 custom schema를 사용할 수 있는 옵션을 추가했습니다.
vout 필드가 추가되었습니다.
Request body에 vout 필드가 추가되었습니다.
Response body에 vout 필드가 추가되었습니다.
(BREAKING CHANGE) verifications DB 테이블에 vout 필드가 추가되었습니다.
아주 드물게 발생하는 ivms101 파싱 오류를 수정했습니다.
아주 드물게 발생하는 데이터베이스 데드락 버그를 수정했습니다.
VerifyName Response API Passthrough 기능이 추가되었습니다.
Vasp connect 기능을 통해 다른 VASP 들과 연결 상태를 변경했을 때, 연결 상태가 바로 적용되지 않았던 버그 수정
Enclave에 위험 평가를 위한 API가 추가되었습니다.
network 필드가 추가되었습니다.
Request body에 network 필드가 추가되었습니다.
Reason 타입에 'UNKNOWN-NETWORK' 가 추가되었습니다.
(BREAKING CHANGE) verifications DB 테이블에 network 필드가 추가되었습니다.
reason 타입에 'NOT-ALLOWED' 값이 추가되었습니다.
낮은 확률로 사용자 검증 결과가 enclave DB에 제대로 저장되지 않는 문제가 수정되었습니다.
CODE 프로토콜과 상호 운용이 가능하도록 수정되었습니다.
VASP 목록 조회 API를 호출하면 CODE 프로토콜을 사용하는 VASP들도 목록에 표시되도록 수정되었습니다.
사용자 검증 VASP API에서 requiredBeneficiaryInfo에 없는 정보를 반환했을 때 enclave에서 해당 정보를 제거하는 로직에 있던 버그가 수정되었습니다.
사용자 검증 VASP API에서 ivms101 본문을 반환하지 않았을 경우, 검증 결과가 ERROR(UNDEFINED-ERROR)로 반환되는 문제가 수정되었습니다.
Oracle 데이터베이스를 사용하는 경우 commands 테이블에서 에러가 발생하는 문제가 수정되었습니다.
VEGA_VERIFICATION_AUTHORIZATION_TOKEN 환경 변수를 설정하지 않았을 경우, authorization header가 잘못 설정되는 문제 수정
사용자 주소 검증 API가 사용자 계정 검증 API로 변경되었습니다.
기존에 지갑 주소만 검증하는 것뿐만 아니라, 선택적으로 이름 매칭 검증도 수행할 수 있도록 변경되었습니다.
Robot VASP를 상대로 좀 더 다양한 케이스를 테스트할 수 있도록 수정하였습니다.
출금 검증 시 다양한 에러 케이스를 테스트할 수 있습니다.
기존에는 최종성(finality)이 확인되면 호출하도록 가이드 했지만, 이제는 트랜잭션의 ID (txHash)를 알아 내자마자 호출하도록 변경되었습니다.
각 API에서 반환될 수 있는 에러 코드가 업데이트되었습니다.
송신 VASP에서 요청하지 않은 수신자의 개인 정보는 기입하지 않습니다. 오직 요청한 정보만 기입하여 반환합니다.
멱등성을 보장하도록 구현해야 합니다. (중복 데이터의 처리가 가능해야 합니다.)
기존에 주소만 검증하던 것에서, 선택적으로 법정 기준 금액 이상인 경우에는 수취인 이름 매칭 검증도 함께 수행할 수 있도록 스펙이 변경되었습니다.
주소 검증 VASP API가 사용자 계정 검증 VASP API로 대체됨에 따라 enclave 환경 변수 이름이 변경되었습니다.
변경 전: VEGA_VERIFICATION_ADDRESS_API_PATH
변경 후: VEGA_VERIFICATION_ACCOUNT_API_PATH
VASP API Authorization Token의 헤더 키값을 지정할 수 있는 환경 변수가 추가되었습니다.
Enclave DB 테이블 중에서 commands 테이블의 index가 변경되었습니다.
commands table의 index 중 "status"와 "fetched_at"으로 구성된 인덱스에 "created_at" 컬럼이 추가되었습니다.
NATURAL_PERSON_COUNTRY_OF_REGISDENCE -> NATURAL_PERSON_COUNTRY_OF_RESIDENCE
LEGAL_PERSON_COUNTRY_OF_REGIDENCE -> LEGAL_PERSON_COUNTRY_OF_REGISTRATION
일부 enclave API의 호출 방식이 비동기 방식으로 변경되었습니다.
동기 방식으로 호출할 때 받았던 response는 이제 callback VASP API로 전달됩니다.
상대방 VASP와 정보를 주고받을 때 필요한 개인 정보 종류를 지정할 수 있는 기능이 추가되었습니다.
해당 기능을 위해 개인 정보 종류 코드가 추가되었습니다. 자세한 사항은 사용자 검증 요청 API 문서와, 사용자 검증 VASP API 문서를 참고하세요.
VASP API 구현 정책이 업데이트되었습니다.
각 VASP API reference 페이지에 구현 정책이 추가되었습니다.
동일 VASP끼리의 거래도 지원합니다. 즉, 수신 VASP가 송신 VASP와 같은 경우에도 지원합니다.
일부 API의 호출 방식이 비동기 방식으로 변경되었습니다.
request body에 requiredBeneficiaryInfo 필드가 추가되었습니다.
비동기 방식 전환으로 인해 response body에서 verificationUuid 필드를 제외한 다른 필드가 삭제되었습니다.
request body에 message 필드가 추가되었습니다.
새로운 API가 추가되었습니다.
일부 API의 비동기 호출 방식 지원에 따라 처리 결과를 비동기적으로 전달받을 수 있는 Callback API를 추가했습니다.
구현하지 않아도 enclave 동작에는 문제가 없으나, 구현하지 않았을 경우에는 사용자 검증 결과나 트랜잭션 결과를 알기 위해서 지속적으로 폴링 해야 하는 부담이 생기므로 구현하는 것을 강력히 권장합니다.
각 VASP API의 구현 정책이 추가되었습니다.
사용자 검증 결과에 대한 에러 코드가 추가되었습니다.
추가 : commands table
변경 : verifications table
message 컬럼 추가
VEGA_VERIFICATION_CALLBACK_API_PATH : callback API endpoint 설정
XRP나 EOS처럼 "부모 주소" 이외의 별도 주소가 필요한 경우
법인의 주소 기입할 때 본점과 사업장의 주소를 모두 기입하도록 정책 추가
Enclave에 데이터베이스 포트 번호를 설정해도 설정값이 적용되지 않던 문제가 수정되었습니다.
Enclave 부팅 시 사용자 검증 API endpoint뿐만 아니라 주소 검증 API, 트랜잭션 처리 상태 조회 API의 endpoint도 접속 여부를 검사하도록 변경되었습니다.
fromAccount -> originatorAccountNumber, toAccount -> beneficiaryAccountNumber
한국 사이트가 오픈하였습니다.
staging 환경 및 사이트만 오픈하였고, production 환경 및 사이트는 추후 오픈 예정입니다.
한국 리전에 연동하고자 하는 VASP들은 한국 콘솔 사이트에 새롭게 회원 가입을 해야 합니다.
Central 서버의 API 주소가 한국 리전에 맞게 변경되었습니다.
enclave 서버의 버전이 업그레이드되었습니다. (verifyvasp/enclave:v1.1.0 다운로드)
enclave 데이터베이스의 다음 테이블의 테이블 정의가 변경되었습니다.
verifications
enclave 데이터베이스의 다음 테이블이 추가되었습니다.
counter_party_keys
own_keys
enclave 데이터베이스에서 특정 컬럼을 암호화하여 저장합니다.
다음 환경 변수가 추가되었습니다.
VEGA_ENCLAVE_PUBLIC_ENDPOINT
VEGA_VERIFICATION_ADDRESS_API_PATH
VEGA_VERIFICATION_TRANSACTION_API_PATH
VEGA_VERIFICATION_AUTHORIZATION_TOKEN
VEGA_ENCRYPTION_KEY_BASE64
VEGA_DECRYPT_API_ENDPOINT
VEGA_PUBLIC_KEY_TTL
VEGA_LOG_LEVEL
VASP에서 구현해야 하는 VASP API가 추가되었습니다.
사용자 address를 검증하는 API를 추가 구현해야 합니다.
Transaction 처리 상태를 반환하는 API를 추가 구현해야 합니다.
데이터베이스 암호화에 사용된 encryption key를 복호화 하는 API를 추가 구현해야 합니다.(필수는 아니지만 권장 사항)
사용자 검증 API의 request body가 변경되었습니다.
symbol, amount 값이 assetInfo 객체 안으로 들어갔습니다. (자세한 내용은 API Spec 문서 참조)
API path에 API version이 추가되었습니다. (/v1)
다음 API가 수정되었습니다.
VASP 목록 조회 API
기본적으로 VerifyVASP에 가입한 VASP 목록만 보이도록 수정하였습니다.
includesAll query parameter를 설정할 수 있도록 수정하였습니다.
VASP의 health 정보를 포함하여 좀 더 상세한 정보가 반환되도록 수정하였습니다.
사용자 검증 요청 API
request body가 수정되었습니다.
다음 API가 추가되었습니다.
주소 검증 API가 추가되었습니다.
Error report API가 추가되었습니다.
Transaction 처리 상태 조회 API가 추가되었습니다.
보안 가이드 문서가 추가되었습니다.
IVMS101 포맷 가이드 문서가 추가되었습니다.
IVMS101 정보 기입 가이드 문서가 추가되었습니다.
에 법인(LegalPerson)을 위한 설립일을 기입할 수 있는 dateOfIncorporation 필드가 추가되었습니다.
를 호출할 때 dateOfIncorporation 값이 있는 경우 입력값 검증이 수행됩니다.
에 LEGAL_PERSON_DATE_OF_INCORPORATION 코드가 추가되었습니다.
의 지리적 주소 항목에서 townName이 더 이상 필수 입력값이 아닙니다.
지갑 주소나 트랜잭션 ID 불일치를 최소화하기 위해 를 제공합니다.
에서 VEGA_DATABASE_SEARCH_PATH 환경 변수를 참고하세요.
Enclave API :
VASP API :
Enclave API : , ,
VASP API :
Enclave API : ,
VASP API : ,
Enclave API : ,
VASP API : , ,
Enclave API :
VASP API : ,
반환값에서 countryCode, protocol 항목이 추가되었습니다.
반환값에서 새로운 vaspStatus 값(INTEROPERATED)이 추가되었습니다.
의 response body에서 count 값이 문자열로 반환되던 문제 수정
자세한 사항은 를 참고하세요.
자세한 사항은 을 참고하세요.
의 호출 정책이 변경되었습니다.
구현 정책 가이드가 업데이트되었습니다.
의 request body에 verificationUuid가 추가되었습니다.
구현 정책 가이드가 업데이트되었습니다.
가 변경되었습니다.
자세한 내용은 의 "VASP API 인증" 부분과 문서를 참고하세요.
자세한 사항은 페이지를 확인해 주세요.
에서 오타가 수정되었습니다.
의 스펙이 변경되었습니다.
삭제된 응답 필드는 를 통해 전달됩니다.
의 스펙이 변경되었습니다.
가 추가되었습니다.
자세한 사항은 를 참고하세요.
에 테이블이 추가 / 변경되었습니다.
가 추가되었습니다.
가 업데이트되었습니다.
reference에 transaction state diagram이 추가되었습니다.
의 query parameter 이름이 정정되었습니다.
VerifyVASP 콘솔 사이트의 주소가 한국 리전에 맞게 변경되었습니다. ()