# JackpotTicketNFT

**Contract Address:** [`0x48FfE35AbB9f4780a4f1775C2Ce1c46185b366e4`](https://basescan.org/address/0x48FfE35AbB9f4780a4f1775C2Ce1c46185b366e4)

ERC-721 contract that mints NFTs representing lottery tickets. Each ticket NFT contains the selected numbers and drawing information.

## State Variables

| Variable      | Type                                | Description                                 |
| ------------- | ----------------------------------- | ------------------------------------------- |
| `jackpot`     | `IJackpot`                          | Immutable reference to the Jackpot contract |
| `ticketArt`   | `ITicketArt`                        | Contract for generating ticket NFT art      |
| `contractURI` | `string`                            | Contract-level metadata URI                 |
| `userTickets` | `mapping`                           | Tracks tickets per user per drawing         |
| `tickets`     | `mapping(uint256 => TrackedTicket)` | Ticket data by token ID                     |

## Structs

### TrackedTicket

```solidity
struct TrackedTicket {
    uint256 drawingId;       // Drawing this ticket is for
    uint256 packedTicket;    // Packed normal numbers and bonusball
    bytes32 referralScheme;  // Hash of referral scheme applied
}
```

### ExtendedTrackedTicket

```solidity
struct ExtendedTrackedTicket {
    uint256 ticketId;        // NFT token ID
    TrackedTicket ticket;    // Core ticket data
    uint8[] normals;         // Unpacked normal numbers
    uint8 bonusball;         // Unpacked bonusball
}
```

### UserTickets (internal)

```solidity
struct UserTickets {
    uint256 totalTicketsBought;                    // Total tickets for this drawing
    mapping(uint256 => uint256) ticketIds;         // Index → ticketId
    mapping(uint256 => uint256) indexOfTicketId;   // ticketId → index
}
```

## Events

### Transfer (ERC-721)

```solidity
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
```

### Approval (ERC-721)

```solidity
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
```

## Functions

### getUserTickets

Get all tickets owned by a user for a specific drawing.

```solidity
function getUserTickets(address user, uint256 drawingId) external view returns (ExtendedTrackedTicket[] memory)
```

**Parameters:**

| Name        | Type      | Description                     |
| ----------- | --------- | ------------------------------- |
| `user`      | `address` | Address of the ticket owner     |
| `drawingId` | `uint256` | Drawing ID to query tickets for |

**Returns:**

| Type                      | Description                                              |
| ------------------------- | -------------------------------------------------------- |
| `ExtendedTrackedTicket[]` | Array of extended ticket info including unpacked numbers |

**Example:**

```solidity
uint256 currentDrawing = jackpot.currentDrawingId();
IJackpotTicketNFT.ExtendedTrackedTicket[] memory myTickets =
    ticketNFT.getUserTickets(msg.sender, currentDrawing);

for (uint256 i = 0; i < myTickets.length; i++) {
    uint256 ticketId = myTickets[i].ticketId;
    uint8[] memory normals = myTickets[i].normals;
    uint8 bonusball = myTickets[i].bonusball;
}
```

***

### getTicketInfo

Get basic ticket information by token ID.

```solidity
function getTicketInfo(uint256 ticketId) external view returns (TrackedTicket memory)
```

**Parameters:**

| Name       | Type      | Description  |
| ---------- | --------- | ------------ |
| `ticketId` | `uint256` | NFT token ID |

**Returns:**

| Type            | Description                                                     |
| --------------- | --------------------------------------------------------------- |
| `TrackedTicket` | Ticket data with drawing ID, packed ticket, and referral scheme |

**Example:**

```solidity
IJackpotTicketNFT.TrackedTicket memory ticket = ticketNFT.getTicketInfo(123);
uint256 drawingId = ticket.drawingId;
```

***

### getExtendedTicketInfo

Get full ticket information with unpacked numbers.

```solidity
function getExtendedTicketInfo(uint256 ticketId) external view returns (ExtendedTrackedTicket memory)
```

**Parameters:**

| Name       | Type      | Description  |
| ---------- | --------- | ------------ |
| `ticketId` | `uint256` | NFT token ID |

**Returns:**

| Type                    | Description                                     |
| ----------------------- | ----------------------------------------------- |
| `ExtendedTrackedTicket` | Complete ticket info including unpacked numbers |

**Example:**

```solidity
IJackpotTicketNFT.ExtendedTrackedTicket memory ticket =
    ticketNFT.getExtendedTicketInfo(123);

// Access unpacked numbers
uint8[] memory normals = ticket.normals;  // e.g., [1, 15, 23, 42, 55]
uint8 bonusball = ticket.bonusball;       // e.g., 10
```

***

### tokenURI

Get the metadata URI for a ticket NFT.

```solidity
function tokenURI(uint256 tokenId) external view returns (string memory)
```

**Parameters:**

| Name      | Type      | Description  |
| --------- | --------- | ------------ |
| `tokenId` | `uint256` | NFT token ID |

**Returns:**

| Type     | Description                                      |
| -------- | ------------------------------------------------ |
| `string` | Base64-encoded JSON metadata URI with ticket art |

***

### ownerOf (ERC-721)

Get the owner of a ticket NFT.

```solidity
function ownerOf(uint256 tokenId) external view returns (address)
```

***

### balanceOf (ERC-721)

Get total NFT balance for an address.

```solidity
function balanceOf(address owner) external view returns (uint256)
```

***

### transferFrom (ERC-721)

Transfer a ticket NFT to another address.

```solidity
function transferFrom(address from, address to, uint256 tokenId) external
```

**Example:**

```solidity
// Transfer ticket to another address
ticketNFT.transferFrom(msg.sender, recipientAddress, ticketId);
```

***

### approve (ERC-721)

Approve another address to transfer a specific ticket.

```solidity
function approve(address to, uint256 tokenId) external
```

***

### setApprovalForAll (ERC-721)

Approve/revoke an operator for all tickets.

```solidity
function setApprovalForAll(address operator, bool approved) external
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.megapot.io/developers/contract-overview/jackpot-ticket-nft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.