โทเค็นหุ้นบน Robinhood Chain: การอ่านตัวคูณ ผู้ถือ และกิจกรรมรายวันด้วย API key เดียว

Robinhood Chain รองรับสินทรัพย์ในโลกแห่งความเป็นจริงในรูปแบบโทเค็น (RWAs) รวมถึงหุ้นสหรัฐฯ และกองทุนซื้อขายแลกเปลี่ยน (ETFs) ในรูปแบบโทเค็น ในขณะที่โทเค็น ERC-20 มาตรฐานจะแมปยอดคงเหลือแบบ 1:1 แต่หุ้นในรูปแบบโทเค็นจะมีการนำตัวคูณการดำเนินการขององค์กรมาใช้ เพื่อรองรับการแตกหุ้นและการปรับเงินปันผลโดยไม่ต้องเปลี่ยนยอดคงเหลือในกระเป๋าเงิน

คู่มือนี้จะอธิบายวิธีการทำงานของตัวคูณโทเค็นหุ้น วิธีแปลงยอดคงเหลือโทเค็นดิบเป็นจำนวนหุ้นอ้างอิง วิธีสืบค้น uiMultiplier บนเชนโดยใช้ JSON-RPC eth_call และวิธีดึงข้อมูลผู้ถือรายวันและกิจกรรมการโอนผ่าน BlockVectra Data API

สำหรับพารามิเตอร์เครือข่ายโดยรวม, นโยบายเมธอด และการตั้งค่า RPC โปรดดู คู่มือ Robinhood Chain สำหรับข้อมูลอ้างอิงฟิลด์แบบครอบคลุมและรูปแบบการใช้ Compute Unit (CU) สำหรับชุดข้อมูลนี้ โปรดดู คู่มือหุ้นในรูปแบบโทเค็น

ตัวคูณโทเค็นหุ้นคืออะไร

โทเค็นหุ้นของ Robinhood เป็นโทเค็น ERC-20 มาตรฐาน (มี 18 decimals) ที่ออกโดย Robinhood Assets (Jersey) Limited (RHJ) เพื่อรองรับการดำเนินการขององค์กร เช่น การแตกหุ้นและการนำเงินปันผลไปลงทุนใหม่ สัญญาเหล่านี้ได้นำมาตรฐาน ERC-8056 (Scaled UI Amount Extension) มาใช้งาน

ตัวคูณ (uiMultiplier) กำหนดอัตราส่วน จำนวนหุ้นต่อหนึ่งโทเค็น:

• ความแม่นยำ: uiMultiplier() แสดงในรูปแบบตัวเลขทศนิยมคงที่ขนาด 18 ตำแหน่ง โดย 1e18 เท่ากับ 1.0
• ค่าเริ่มต้น: เมื่อออกโทเค็น ตัวคูณจะถูกกำหนดค่าเริ่มต้นเป็น 1e18 (หนึ่งโทเค็นแทนหนึ่งหุ้นอ้างอิง)
• การดำเนินการขององค์กร: เมื่อเกิดเหตุการณ์ระดับองค์กร (เช่น การแตกหุ้นไปข้างหน้า หรือการนำเงินปันผลไปลงทุนใหม่) สัญญาโทเค็นจะอัปเดต uiMultiplier และส่ง event UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp)

ยอดคงเหลือโทเค็นคงที่ระหว่างการแตกหุ้น

โทเค็นหุ้นไม่ใช่โทเค็นประเภท rebasing ระหว่างการดำเนินการขององค์กร:

• ยอดคงเหลือในกระเป๋าเงิน (balanceOf(account)) และการออกโทเค็นทั้งหมด (totalSupply()) จะไม่มีการเปลี่ยนแปลง
• มีเพียงตัวคูณปรับสเกลเท่านั้นที่เปลี่ยนแปลง

ตัวอย่างเช่น หากหุ้นอ้างอิงดำเนินการแตกหุ้นไปข้างหน้าแบบ 2 ต่อ 1:

• ผู้ถือที่ครอบครอง 10 โทเค็นจะยังคงถือ 10 โทเค็นใน balanceOf
• สัญญาจะอัปเดต uiMultiplier จาก 1.0 (1e18) เป็น 2.0 (2e18)
• แต่ละโทเค็นจะแทน 2 หุ้นอ้างอิง ทำให้ผู้ถือได้รับสิทธิประโยชน์เสมือนถือ 20 หุ้น

การแปลงยอดคงเหลือเป็นจำนวนหุ้น

ในการคำนวณจำนวนหุ้นอ้างอิงที่แสดงโดยยอดคงเหลือโทเค็น ให้ใช้สูตร ERC-8056:

underlying shares = raw token amount × uiMultiplier ÷ 1e18

สัญญาโทเค็น ERC-8056 ยังมีฟังก์ชันช่วยเหลือแบบอ่านอย่างเดียวบนเชน:

• balanceOfUI(address account): ส่งคืนยอดคงเหลือของบัญชีโดยแสดงเป็นจำนวนหุ้นอ้างอิงโดยตรง (ปรับสเกลด้วย uiMultiplier, 18 decimals)
• totalSupplyUI(): ส่งคืนอุปทานโทเค็นทั้งหมดโดยแสดงเป็นจำนวนหุ้นอ้างอิงโดยตรง

นอกจากนี้ การโอนโทเค็นจะส่ง event TransferWithScaledUI(address indexed from, address indexed to, uint256 value, uint256 uiValue) ออกมา เพื่อบันทึกทั้งจำนวนโทเค็นดิบและจำนวนหุ้นอ้างอิงที่ปรับสเกลแล้ว

ตัวคูณและ Price Feed ของ Oracle

Robinhood Chain ได้ดีพลอย Chainlink price feed (AggregatorV3Interface) โดยเฉพาะสำหรับแต่ละโทเค็นหุ้น:

• Chainlink price feed (latestRoundData()) ได้รวมตัวคูณเข้าไปเรียบร้อยแล้ว โดยจะสะท้อนราคาตลาดเต็มรูปแบบของหนึ่งโทเค็น (ราคาหุ้นอ้างอิงคูณด้วยตัวคูณ)
• แอปพลิเคชันที่อ่าน Chainlink oracle บนเชนจะได้รับราคาที่ปรับด้วยตัวคูณแล้วโดยตรง และต้องไม่นำตัวคูณไปคูณซ้ำเป็นครั้งที่สอง
• ข้อมูลเมทาดาตาแบบ off-chain สามารถตรวจสอบได้ผ่าน REST endpoint ของ Robinhood GET https://api.robinhood.com/rhj/assets ซึ่งให้ข้อมูล currentMultiplier และ pendingMultiplier

การอ่านตัวคูณด้วย JSON-RPC eth_call

คุณสามารถตรวจสอบตัวคูณของหุ้นในรูปแบบโทเค็นใดๆ ได้โดยตรงผ่าน JSON-RPC endpoint ของ BlockVectra สำหรับ Robinhood Chain โดยใช้ eth_call:

• ฟังก์ชัน: uiMultiplier()
• ตัวเลือกฟังก์ชัน 4 ไบต์: 0xa60bf13d (bytes4(keccak256("uiMultiplier()")))
• รูปแบบการส่งคืน: uint256 ที่เข้ารหัสฐานสิบหกขนาด 32 ไบต์ (ค่า fixed-point 18 ตำแหน่ง)

BlockVectra ให้บริการคำขอ JSON-RPC ของ Robinhood Chain ภายใต้ https://api.blockvectra.com/v1/robinhood_mainnet ให้ส่ง API key ของคุณผ่านส่วนหัว x-api-key หรือต่อท้ายในพาธ (https://api.blockvectra.com/v1/robinhood_mainnet/{api_key})

ตัวอย่างโค้ด

ตัวอย่างด้านล่างนี้สอบถาม uiMultiplier() บนสัญญาโทเค็นหุ้น Everpure (0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D):

curl -s "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_call",
    "params": [
      {
        "to": "0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D",
        "data": "0xa60bf13d"
      },
      "latest"
    ]
  }'

การสืบค้นผู้ถือและกิจกรรมรายวันด้วย Data API

BlockVectra Data API มีข้อมูลสรุปรายวันที่จัดทำดัชนีไว้ล่วงหน้าสำหรับหุ้นในรูปแบบโทเค็น ใช้ GET /v1/data/robinhood_mainnet/stocks สำหรับกระดานผู้นำกิจกรรมรายวัน และ GET /v1/data/robinhood_mainnet/stocks/{token} สำหรับเมทาดาตาของโทเค็นหนึ่งรายการและเมตริกรายวันย้อนหลังสูงสุด 30 วัน ดูพารามิเตอร์คำขอ ฟิลด์การตอบกลับ และตัวอย่างได้ที่ คู่มือหุ้นในรูปแบบโทเค็น

หมายเหตุทางกฎหมายและข้อบังคับ

โทเค็นหุ้นเป็นหลักทรัพย์ตราสารหนี้ในรูปแบบโทเค็นที่ออกโดย Robinhood Assets (Jersey) Limited (RHJ) โปรดดู เอกสาร Robinhood RHJ สำหรับหนังสือชี้ชวน ข้อกำหนดขั้นสุดท้าย และประกาศเกี่ยวกับเขตอำนาจศาล

ขั้นตอนถัดไป

• เลือกดูไดเรกทอรีชุดข้อมูล เพื่อดูชุดข้อมูลทั้งหมดที่ BlockVectra จัดทำดัชนี
• ดูแพ็กเกจฟรีและการกำหนดราคา เพื่อตรวจสอบสิทธิประโยชน์ในบัญชีของคุณ
• เข้าสู่ระบบคอนโซล เพื่อสร้าง API key