refactor(prize)!: payout_prize_extension replaces claim_prize_extension

Mirrors the metagame-extensions trait refactor: extensions are now
asset managers driven by the host. The host computes recipient (winner
for normal payout, sponsor for refund) and tells the extension where
to send via a single payout_prize call. No separate claim/refund
methods on the host dispatcher either.

Bumps metagame-extensions to dbe56fa.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: Starknet Dev

Scarb.toml

@@ -41,7 +41,7 @@ openzeppelin_introspection = { git = "https://github.com/OpenZeppelin/cairo-cont
 openzeppelin_token = { git = "https://github.com/OpenZeppelin/cairo-contracts.git", tag = "v3.0.0" }
 openzeppelin_interfaces = { git = "https://github.com/OpenZeppelin/cairo-contracts.git", tag = "v3.0.0" }
 ekubo = { git = "https://github.com/EkuboProtocol/starknet-contracts.git", tag = "v4.0.1" }
-metagame_extensions_interfaces = { git = "https://github.com/Provable-Games/metagame_extensions.git", rev = "51ac398f2fb4a0fa30f3e601b0eb3f0daabd8994" }
+metagame_extensions_interfaces = { git = "https://github.com/Provable-Games/metagame_extensions.git", rev = "dbe56fa608fd9f37766758c9e21c37546fad1346" }
 alexandria_merkle_tree = { git = "https://github.com/keep-starknet-strange/alexandria.git", tag = "v0.9.0" }
 
 [dependencies]

packages/metagame/src/prize/prize_component.cairo

@@ -433,25 +433,32 @@ pub mod PrizeComponent {
             dispatcher.add_prize(context_id, prize_id, ext.config);
         }
 
-        /// Forward a claim call to the prize extension configured for
+        /// Forward a payout call to the prize extension configured for
         /// `(context_id, prize_id)`. Reverts if `prize_id` was added via
-        /// the built-in `Prize::Config` path (no extension address
-        /// stored). `claim_params` is opaque — the extension deserializes
-        /// whatever shape it expects.
+        /// the built-in `Prize::Token` path (no extension address
+        /// stored).
+        ///
+        /// The host (e.g. budokan) decides whether the payout is a winner
+        /// distribution or a sponsor refund by picking the right
+        /// `recipient`. The extension itself is a dumb asset manager —
+        /// it just transfers the escrow at `(prize_id, position)` to
+        /// `recipient`. Per-position payout dedupe lives on the
+        /// extension, not the host.
         ///
         /// Hosts are responsible for any cross-cutting concerns
-        /// (finalization checks, reentrancy guards, double-claim
-        /// protection on the host side) before invoking this.
-        fn claim_prize_extension(
+        /// (finalization checks, reentrancy guards) before invoking this.
+        fn payout_prize_extension(
             ref self: ComponentState<TContractState>,
             context_id: u64,
             prize_id: u64,
-            claim_params: Span<felt252>,
+            position: u32,
+            recipient: ContractAddress,
+            payout_params: Span<felt252>,
         ) {
             let extension_address = Store::get_extension_address(@self, context_id, prize_id);
             assert!(!extension_address.is_zero(), "Prize: No extension configured for prize");
             let dispatcher = IPrizeExtensionDispatcher { contract_address: extension_address };
-            dispatcher.claim_prize(context_id, prize_id, claim_params);
+            dispatcher.payout_prize(context_id, prize_id, position, recipient, payout_params);
         }
 
         /// Payout full ERC20 amount to a recipient

packages/metagame/src/prize/tests/mocks/prize_mock.cairo

@@ -139,12 +139,17 @@ pub mod PrizeMock {
         self.prize.get_extension_address(context_id, prize_id)
     }
 
-    /// Forward a claim to the prize extension for (context_id, prize_id).
+    /// Forward a payout to the prize extension for (context_id, prize_id).
     #[external(v0)]
-    fn claim_prize_extension(
-        ref self: ContractState, context_id: u64, prize_id: u64, claim_params: Span<felt252>,
+    fn payout_prize_extension(
+        ref self: ContractState,
+        context_id: u64,
+        prize_id: u64,
+        position: u32,
+        recipient: starknet::ContractAddress,
+        payout_params: Span<felt252>,
     ) {
-        self.prize.claim_prize_extension(context_id, prize_id, claim_params);
+        self.prize.payout_prize_extension(context_id, prize_id, position, recipient, payout_params);
     }
 
     /// Add a prize (delegates to component). Exposes the full Prize sum-type

packages/metagame/src/prize/tests/test_prize_store.cairo

@@ -32,8 +32,13 @@ trait IPrizeMockFull<TContractState> {
     fn get_extension_address(
         self: @TContractState, context_id: u64, prize_id: u64,
     ) -> ContractAddress;
-    fn claim_prize_extension(
-        ref self: TContractState, context_id: u64, prize_id: u64, claim_params: Span<felt252>,
+    fn payout_prize_extension(
+        ref self: TContractState,
+        context_id: u64,
+        prize_id: u64,
+        position: u32,
+        recipient: ContractAddress,
+        payout_params: Span<felt252>,
     );
     fn add_prize(
         ref self: TContractState, context_id: u64, prize: crate::prize::structs::Prize,
@@ -226,11 +231,11 @@ fn test_extension_address_default_zero() {
 }
 
 // ============================================================================
-// claim_prize_extension dispatch
+// payout_prize_extension dispatch
 // ============================================================================
 
 #[test]
-fn test_claim_prize_extension_dispatches_when_configured() {
+fn test_payout_prize_extension_dispatches_when_configured() {
     let mock = deploy();
     let ext_addr = addr(0xE0E0E0);
 
@@ -250,15 +255,15 @@ fn test_claim_prize_extension_dispatches_when_configured() {
             ),
         );
 
-    // Mock the extension's claim entrypoint and verify the component
+    // Mock the extension's payout entrypoint and verify the component
     // dispatches without panicking.
-    mock_call(ext_addr, selector!("claim_prize"), (), 10);
-    mock.claim_prize_extension(42, prize_id, array![0xBEEF].span());
+    mock_call(ext_addr, selector!("payout_prize"), (), 10);
+    mock.payout_prize_extension(42, prize_id, 1, addr(0xFEED), array![].span());
 }
 
 #[test]
 #[should_panic(expected: "Prize: No extension configured for prize")]
-fn test_claim_prize_extension_panics_when_unset() {
+fn test_payout_prize_extension_panics_when_unset() {
     let mock = deploy();
-    mock.claim_prize_extension(1, 1, array![].span());
+    mock.payout_prize_extension(1, 1, 1, addr(0xFEED), array![].span());
 }